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PREFACE 



This publication provides user reference information for the software 
that logically links a VAX Computer System, manufactured by Digital 
Equipment Corporation (DEC), to a CRAY X-MP or CRAY-1 Computer System. 
The software providing the logical link is a set of programs running 
under the VAX/VMS operating system. This software link was developed by 
Cray Research, Inc. (CRI) as a service to its customers. 

This software is referred to as the VAX/VMS station throughout this 
publication. The VAX/VMS station requires the Virtual Memory System 
(VMS) version 4 or higher, and the Cray operating system COS version 1.13 
or later. If remote stations are installed, the system must include 
DECnet. 

This publication is intended for users of COS who want to transfer jobs, 
data, and interactive commands to, from, or through a connected VMS 
system. The publication provides both tutorial information for new users 
of the VAX/VMS station and detailed reference information for experienced 
users. 

This publication assumes a general understanding of the characteristics 
of VMS and COS. In particular, familiarity with the following 
publications is recommended: 

• COS Version 1 Reference Manual, publication SR-0011 

• VAX/VMS DCL Dictionary, DEC publication AA-Z200A-TE 

• VAX Record Management Services Reference Manual, DEC publication 
AA-Z503A-TE 

• Introduction to VAX/VMS, DEC publication AA-Y500A-TE 

• Guide to Using DCL and Command Procedures on VAX/VMS, DEC 
publication AA-Y501A-TE 

The following CRI publications also support the VAX/VMS station: 



• DEC VAX/VMS Station Message Manual, publication SV-0101 

• DEC VAX/VMS Station Ready Reference, publication SV-0102 

• DEC VAX/VMS Station Operator's Guide, publication SV-0063 

• DEC VAX/VMS Station Installation and Maintenance Reference Manual, 
publication SV-0100 

• DEC VAX/VMS Station Internal Reference Manual, publication SV-0062 
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INTRODUCTION 1 



This section introduces you to the characteristics, capabilities, and 
configuration of the VAX/VMS station. The following topics are addressed: 

• What is the VAX/VMS station? 

• What capabilities does the station provide? 

• What is the physical connection? 

• Conventions 

• Gaining access to VMS 

Terminal facilities of the VAX/VMS station are discussed in section 2. 

If you are a new user of the VAX/VMS station, see appendix A for two 
sample terminal sessions that draw on the activities discussed in this 
manual and provide on-line experience in preparing, submitting, and 
monitoring jobs that you send to COS. The Command Reference section 
later in this manual provides descriptions and examples of all VAX/VMS 
station commands available to users. 



1.1 WHAT IS THE VAX/VMS STATION? 

The VAX/VMS station is a software product that controls the link between 
a Digital Equipment Corporation (DEC) VAX Computer System and a CRAY X-MP 
or CRAY-1 Computer System. 

By using the VAX/VMS station, you can access CRAY X-MP or CRAY-1 
facilities from within the Digital VAX/VMS environment. When at a 
terminal connected to the VAX/VMS operating system you can, for example, 
submit a job to COS for processing. 

Two types of VAX/VMS stations provide you with access to the Cray 
Computer System. They are: 

• The attached VAX/VMS station, which is located at a DEC VAX 

Computer System connected directly to the Cray Computer System. 
The attached VAX/VMS station controls the network that is composed 
of one or more remote VAX/VMS stations. 
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• The remote VAX/VMS station, which is located at a VAX/VMS DECnet 
remote node. Remote VAX/VMS stations communicate through the 
attached VAX/VMS station to access the Cray Computer System. 

The CRAY X-MP or CRAY-1 Computer System runs under the control of the 
COS; the VAX front-end computer system runs under the control of the 
Virtual Memory System (VMS). 



1.2 WHAT CAPABILITIES DOES THE STATION PROVIDE? 

The attached VAX/VMS station provides the following capabilities to users: 

• Submission of COS batch jobs at VMS terminals (see section 3) 

• Submission of COS batch jobs from within batch jobs running under 
the VAX/VMS Operating System (see section 3) 

• Interactive log on to COS (see section 7) 

• Execution of COS job control statements typed in interactive mode 
(see section 7) 

• Interactive dialogue with user applications or COS utilities in 
interactive mode (see section 7) 

• Submission of VMS batch jobs from within jobs running under COS 
(see section 5) 

• Dataset transfer from VMS disks or tapes to Cray mainframe mass 
storage when requested by a COS job (ACQUIRE or FETCH processing) 
(see sections 4 and 6) 

• Dataset transfer from Cray mainframe mass storage to VMS disks, 
queues, or tapes when requested by a COS job (DISPOSE processing) 
(see sections 4 and 5) 

• Printing of job output files generated by COS jobs on VMS printers 
(see section 5) 

• Interactive or batch output to specialized graphic devices (see 
section 5) 

A subset of these features is provided to users of remote VAX/VMS 
stations that are connected through DECnet to an attached VAX/VMS 
station. This subset includes all the features previously listed, with 
the exception of COS interactive processing (which is available to remote 
station users by using the DEC VAX/VMS SET HOST command) . 
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1.3 WHAT IS THE PHYSICAL CONNECTION? 

The physical connection between the Cray Computer System and the VAX 
front-end system is either: 

• A channel-to-channel front-end coupler device, manufactured by 
CRI, or 

• A HYPERchannel™ network, manufactured by Network Systems 
Corporation. 

Figure 1-1 shows the resulting configuration. 
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Figure 1-1. VMS/COS Hardware Configuration 
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1.4 CONVENTIONS 
This manual uses 
Convention 
UPPERCASE 
{ } Braces 



[ ] Square 
Brackets 

italics 

( ) Round 

Brackets 

< > Angle 

Brackets 



/qualifier 



Boldface 



CTRL/ a 



<RET> 



the following conventions: 

Description 

Indicates the command verb or qualifier parameter 

Encloses stacked literal parameters when only one item 
can be entered 

Encloses optional portions of a command format 

Indicates variable information 
Identifies an optional argument 

Encloses a formal parameter 



Indicates string delimiters for character string data 
containing: 

• Literal lowercase letters 

• Required multiple blank or tab characters 

• Any nonalphanumeric character 

Indicates additional parameters can be specified 

Denotes the beginning of a command qualifier and is a 
mandatory component of the qualifier 

Identifies the part of an example you enter at the 
terminal; system responses or displays are in regular 
type. 

Indicates control key sequences. You hold down the 
CTRL key while pressing a. In some examples, 
control key sequences are shown as a circumflex ( ) 
and a letter, for example Y, because that is how the 
system echoes when you enter CTRL/Y. 

Represents the return key on a DEC-compatible terminal 
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1.5 GAINING ACCESS TO VMS 

Gaining access to VMS is fully described in the Introduction to VAX/VMS, 
DEC publication AA-Y500A-TE, but for completeness the following 
paragraphs provide a brief description of the log on and log out 
procedures. 



1.5.1 VMS LOG ON 

To begin a VMS terminal session, press the RETURN or the CTRL/Y key at 
any terminal physically connected to the VAX/VMS system. VMS prompts for 
your user name. After you enter the user name, VMS prompts for the 
password associated with the user name. The screen does not display your 
entry of the password. 



Example: 

User name: CRAYUSER<RET> 
Password: 

During this sequence, VMS validates that you are authorized to use VMS. 

When a VMS log on is successfully completed, the terminal normally enters 
Digital Command Language (DCL) command state and prompts you with a 
dollar sign ($) at the far left side of the terminal. You can enter 
commands whenever the DCL prompt appears on the terminal. 

If you enter the user name or password incorrectly, the system displays 
an error message and the log-on sequence must be repeated. 



1.5.2 VMS LOG OUT 

When your session is over, disconnect the terminal from the VMS system by 
typing LOGOUT after the DCL prompt: 

$ LOGOUT < RET > 
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USING THE TERMINAL FACILITIES 



This section introduces you to the terminal facilities of the VAX/VMS 
station. Along with providing introductory material, section 2 presents 
examples that illustrate the performance of basic VAX/VMS station 
activities. This section discusses the following topics: 

Entering station commands 

Understanding the format of station commands 

Performing station activities 

Entering station commands at DCL level 

Using Cray context 

Command prompting 

Getting help with the VAX/VMS station 

Using the screen-handling facilities 

Handling indirect station command files 

Using commands in VAX/VMS command procedures 

Selecting Cray Computer Systems 

The section also presents tables that describe all commands available to 
users. The commands are listed in functional categories to provide a 
quick overview of VAX/VMS station capabilities. 

If you are a new user of the VAX/VMS station, see appendix A for two 
sample terminal sessions that draw on the skills discussed in this 
section and provide on-line experience in preparing, submitting, and 
monitoring COS jobs. All station commands discussed in this section are 
described in the Command Reference section. 



2.1 ENTERING STATION COMMANDS 

You can enter station commands in one of two ways to access the 
facilities of the station: 

• At DCL level, by entering the CRAY station command immediately 
followed by another station command. For example: 

$ CRAY HELP < RET > 
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This command entered at DCL level calls the station HELP 
facility. See subsection 2.4 for a more detailed discussion of 
entering station commands at DCL level. 

• By entering the CRAY station command at DCL level, entering Cray 
context, and issuing commands within Cray context. When you are 
within Cray context, enter station commands after the CRAY> prompt: 

$ CRAY < RET > 
CRAY> HELP < RET > 

This command also calls the station HELP facility. Subsection 2.5 
discusses entering station commands from within Cray context in 
more detail. 

You can enter station commands in lowercase or uppercase letters at any 
terminal logged on to VMS. The system prompts for mandatory parameters. 
With the exception of the SUBMIT station command, entering a carriage 
return after a prompt terminates the command. 



2.2 UNDERSTANDING THE FORMAT OF STATION COMMANDS 

Station commands have the following format: 

<station command>/< command qualifier) <parameters> 

The station command describes the station function to be performed; 
command qualifiers modify a station command by providing additional 
information on how the command should be executed; and command 
parameters specify the object of the command, which is often a VMS file. 

If you enter the station command from DCL level, it must be preceded on 
the same line by the CRAY station command. You can define your own 
symbols for station commands by using the DCL symbol command in the 
following format: 

new-symbol :== 'CRAY station- command' 

The following example illustrates this format: 

CSUBMIT :== 'CRAY SUBMIT' 

Station commands can be abbreviated to any length. If an abbreviated 
command string is ambiguous, the system executes the first eligible 
station command. 
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In the following example, the VAX/VMS station command SUBMIT sends the 
jobfile CRAYJOB.JOB to the the Cray Computer System for processing. 
Because you enter the command from DCL level, the CRAY station command 
precedes the SUBMIT station command. 

$ CRAY SUBMIT/PRINT CRAY JOB . JOB < RET > 

*oCX-S-SUB_OK, Job: CRAYPRO queued for submission 
$ 

$ VMS prompt for command input 

CRAY Executes a single station command at DCL level 

SUBMIT Station command that queues a file for sending to 

the COS job input queue 

/PRINT Qualifier to the station command SUBMIT, 

requesting that when the COS $OUT file for the 
job is returned, it is printed 

CRAYJOB.JOB Command parameter naming the job input file to be 

sent to the Cray Computer System for processing 

%CX-S-SUB_OK, Job: CRAYPRO queued for submission 

Message from the station command SUBMIT 
indicating the file CRAYJOB.DAT is queued in the 
station COS job input queue. The SUBMIT command 
extracts the COS job name (CRAYPRO) from line 1 
of the job input file which must be a COS JOB 
control statement. 



2.3 PERFORMING STATION ACTIVITIES 

As a user, you can use station commands to perform the following types of 
activities: 



• 



• 



• 



• 



Staging datasets 

Manipulating jobs 

Using interactive processing (from attached stations only) 

Displaying information 

Displaying format 

Displaying job and dataset status 
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• Controlling messages 

• Using indirect station command files 

• Selecting and accessing modes and systems 



Tables 2-1 through 2-7 describe the station commands related to each of 
these activities. 



Table 2-1. Station Commands for Staging Datasets 



Command 


Function 


REMOVE 


Deletes entries in the VAX/VMS station staging queue to 




COS 


SAVE 


Stages a single file to COS mass storage 


SHOW QUEUES 


Displays entries in the VAX/VMS station dataset staging 




queue 


SUBMIT 


Stages a job to COS 



Table 2-2. Station Commands for Manipulating Jobs 



Command 


Function 


DROP 


Drops a COS job 


KILL 


Kills a COS job 


RELEASE 


Releases a dataset held on the COS job queue 


RERUN 


Reruns a COS job 


SWITCH 


Manipulates the COS job sense switches 



SV-0020 



2-4 



Table 2-3. Station Commands for Using Interactive Processing 



Command 


Function 


ABORT 


Interrupts the current interactive COS job step and 




returns to the Control Statement Processor (CSP) 


ATTACH 


Redirects COS interactive terminal output 


ATTENTION 


Interrupts the current interactive COS job step and 




enters reprieve processing 


BYE 


Terminates an interactive session 


COLLECT 


Stores COS interactive output in a VMS file 


DISCARD 


Discards interactive output from COS 


EOF 


Sends an end-of-file record to the current COS 




interactive job 


INTERACTIVE 


Initiates an interactive session 


I STATUS 


Displays the status of the user's interactive job 


QUIT 


Terminates an interactive session and the corresponding 




COS job 



Table 2-4. Station Commands for Displaying Information 



Command 



Function 



Displaying format 

Gets the next page of a refresh display 
Gets the previous page of a refresh display 

CLEAR Clears the screen display area 
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Table 2-4. Station Commands for Displaying Information (continued) 



Command 



Function 



SET TERMINAL 
SNAP 



Sets the terminal working environment 

Copies the display screen image to a VAX/VMS file 



Displaying job and dataset status 



DATASET 
I STATUS 
JOB 
JSTAT 

SHOW QUEUES 

STATUS 
TAPE 



Reports the existence of a COS permanent dataset 

Displays the status of the user's interactive job 

Displays the status of a specific COS job 

Displays the status of a specific job and its related 
tasks 

Displays entries in the VAX/VMS station dataset staging 
queue 

Displays COS status 

Displays COS tape device information 



Table 2-5. Station Commands for Controlling Messages 



Command 


Function 


HELP 


Displays information from the station help files 


LOGFILE 


Provides access to the station logfile messages 


MESSAGE 


Enters a message into the COS job logfile, the COS 




system logfile, or both 
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Table 2-6. Station Commands for Using Indirect Command Files 



Command 


Function 


Qfile-spec 


Executes an indirect station command file from this VMS 




file specification 


COMMENT 


Inserts comments into a command stream 


DELAY 


Suspends execution of an indirect station command file 




for a specified time 


LOOP 


Restarts execution of an indirect station command file 


PAUSE 


Suspends execution of an indirect station command file 




and switches control to the terminal 


PLAY 


Executes an indirect station command file 


RECORD 


Starts or stops the recording of terminal input for 




later use with the PLAY command 



Table 2-7. Station Commands for Selecting and 
Accessing Modes and Systems 



Command 


Function 


$ 


Allows entry of DCL commands from within Cray context 




command mode 


CTRL/Z 


Returns the user to previous state 


CHOOSE 


Selects a Cray Computer System to be accessed 




(installation defined) 


CRAY 


Enters the user into Cray context or executes a single 




station command 


EXIT 


Returns the user from Cray context command mode to DCL 




command state 



SV-0020 



2-7 



2.4 ENTERING STATION COMMANDS AT DCL LEVEL 

You can enter station commands at DCL level in response to the DCL 
prompt, which is normally represented by the dollar sign ($). All 
station commands you enter at DCL level must be preceded on the same 
command entry line by the CRAY command. You can enter most station 
commands from within Cray context, without the CRAY prefix, in response 
to the prompt CRAY> . 



Example : 

$ CRAY SUBMIT MYJ0B1 . JOB < RET > 

%CX-S-SUB_OK, Job: MYJ0B1 queued for submission 
$ 

In this example, the station command SUBMIT sends the job file MYJOBl.JOB 
to the COS staging queue. 



2.5 USING CRAY CONTEXT 

Cray context provides you with a command selection mechanism, a gateway 
to COS interactive processing, and an optional refreshed display 
capability. Generally, VAX/VMS station commands are available both at 
DCL level and from within Cray context. A subset of commands related to 
refreshed display and interactive processing is, however, available only 
within Cray context. 

Within Cray context you can recall, edit, and reissue commands and Cray 
interactive input by the same method that is provided by VMS. This 
facility stores the last 20 lines of input in a recall buffer. See the 
VAX/VMS DCL Dictionary, DEC publication AA-Z200A-TE, for information on 
terminal usage, recall, and editing. 

To enter Cray context, type the CRAY station command after the DCL prompt 
at your terminal. The system responds by displaying the CRAY> prompt: 

$ CRAY < RET > 
CRAY> 

You can now enter station commands after the CRAY> prompt. 

CRAY> SUBMIT MYJOB1 . JOB < RET > 

%CX-S-SUB_OK, Job: MYJOB1 queued for submission 

CRAY> SUBMIT MYJOB2 . JOB<RET> 

%CX-S-SUB_OK, Job: MYJOB2 queued for submission 
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You can terminate the session by entering the EXIT station command or 
CTRL/Z. The system responds by returning you to DCL level and the DCL 
prompt. 

CRAY> EXIT < RET > 
$ 

Cray context operates in three modes: 

• Command mode - in which you enter station commands 

• Interactive mode - in which you communicate with COS directly 

• DCL mode - in which you enter DCL commands, as if at DCL level, 
without permanently exiting Cray context 

The following subsections discuss command mode, interactive mode, and DCL 
mode. Figure 2-1 shows the relationship between these modes of command 
processing. 



2.5.1 COMMAND MODE 

Cray context command mode is a scrolled terminal environment that makes 
it convenient for you to enter station commands. In command mode, you 
enter station commands after the CRAY> prompt. The examples in 
subsection 2.5 illustrate command mode. 

Refresh and nonrefresh are the two display styles available in command 
mode. 

Refresh style is available on terminals that have the DEC_CRT option 
(for example, the VT100). Refresh style permits you to enter station 
commands while the requested display is dynamically updated. 

Refresh style uses a split-screen environment: the lower part is a 
scrolled command region and the top part is a refreshed display 
region where a number of displays are available. The last requested 
display is refreshed, or rebuilt at regular intervals, until you enter a 
new display request command at your terminal. 

A region divider splits the two screen regions and presents the 
following summary information: 

• Current date and time 

• Node name, if the station exists in a DECnet network or cluster 
environment. On remote stations, both the attached and remote 
nodes are displayed. 
Current display command 



• 



• Current page being displayed 
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DCL Level 



CRAY 



EXIT or CTRL/Z 



Command 
Mode 



CTRL/Z 
(temporary^) 



$[ command] 



$ LOGOUT 



DCL Mode 



INTERACTIVE 



Interactive 
Mode 



CRAY CONTEXT 



f Change is permanent if the command entered ends 
the interactive session. 



1351 



Figure 2-1. Relationship between DCL, Command Mode, 
Interactive Mode, and DCL Mode 



Figure 2-2 shows the refresh style screen format. The region divider is 
displayed in reverse video (light background with dark letters) and is 
updated at each refresh interval. 

Nonrefresh style provides command selection in a terminal-independent 
manner. When you enter a display station command (such as STATUS) in 
nonrefresh style, the system responds by producing a single snapshot 
display. Nonrefresh style is the default if your terminal does not have 
the DEC_CRT facility. The /NOREFRESH qualifier of the CRAY station 
command activates nonrefresh style on display screens with the advanced 
video facility. 
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Refresh Display Region 



Region Divider 



"> 



dd-mmm-yuyy hh : mm:ss. cc Node name Current command page n 



Scrolled Command Region 



Figure 2-2. Cray Context Refresh Style Terminal Use 



As a comparison, if you are in refresh style, you need to enter the 
station command STATUS just once to activate a COS status display that is 
updated at each refresh interval. If you are in nonrefresh style, 
however, you must enter the STATUS station command each time you desire 
an updated COS status display. 



2.5.2 INTERACTIVE MODE 

Cray context interactive mode allows you to communicate with COS 
directly. Use the INTERACTIVE station command to enter interactive mode. 

If you are in refresh command mode when you enter the INTERACTIVE 
command, the split-screen working environment is maintained. The top 
part (previously the refresh display region) is used as a COS interactive 
dialogue area. A Cray interactive banner replaces the usual divider. 
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You can return to command mode by entering CTRL/Z in the COS interactive 
dialogue area. Normally, you can then enter only one command in the 
scrolled command region. If the command is, however, either a Cray 
context display request command or a command that terminates the 
interactive session, you remain in command mode. To return to 
interactive mode, issue the INTERACTIVE command. 

See section 7 for a detailed discussion of interactive processing. 



2.5.3 DCL MODE 

DCL mode permits you to execute DCL commands or DCL command procedures 
while inside Cray context. To use DCL command while you are in Cray 
context command mode, prefix the DCL command with a $. To return to 
command mode, issue the DCL command LOGOUT. 



2.6 COMMAND PROMPTING 

When you enter a station command at a terminal, you do not need to enter 
the entire command on one line. The VAX/VMS station provides prompts for 
mandatory parameters. 

For example, if you enter the SUBMIT station command prefixed by the CRAY 
command, the station provides the following prompts: 

$ CRAY SUBMIT < RET > 
SUBMIT_file: CRAY JOB. JOB < RET > 

SUBMIT_f ile: <RET> 

%CX-S-SUB_OK, Job: CRAY JOB queued for submission 

$ 

If you enter Cray context before issuing the SUBMIT station command, the 
system provides the following prompts: 

$ CRAY<RET> 

CRAY> SUBMIT<RET> 

SUBMIT_file: CRAYJOB. JOB<RET> 

SUBMIT_file:<RET> 

VZX-S-SUBJDK, Job: CRAYJOB queued for submission 

CRAY> 

If you cannot enter a mandatory parameter in response to a system prompt, 
press the carriage return to either abort or terminate the parameter 
list. With the exception of the SUBMIT station command, entering a 
carriage return after a prompt terminates the command. 



SV-0020 2-12 



2.7 GETTING HELP WITH THE VAX/VMS STATION 

If you are using the VAX/VMS station and do not have easy access to a 
reference manual, use the on-line station HELP facility for information 
about all available station commands. You can access the station HELP 
facility at two levels: 

• To get general information about all station commands/ use the 
HELP command as follows: 

$ CRAY HELP < RET > 

or 

$ CRAY<RET> 
CRAY> HELP < RET > 

• To get command-specific information about station commands, use 
the HELP command as follows: 

$ CRAY HELP SUBMIT < RET > 

or 

$ CRAY < RET > 

CRAY> HELP SUBMIT < RET > 

In this example, the system responds by displaying information 
about the SUBMIT station command. 



2.8 ALTERING THE REFRESH-STYLE ENVIRONMENT 

You can use the SET, CLEAR, and paging commands when working within 
refresh-style Cray context to alter the split-screen environment. The 
split-screen working environment is available to terminals with the 
DEC_CRT option, such as the VT100 . The following subsections explain how 
to use station commands and command parameters to manage your 
split-screen terminal environment. 

For a more detailed discussion of these commands, see the Command 
Reference section. 
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2.8.1 USING THE SET TERMINAL STATION COMMAND 

The SET TERMINAL station command enables you to set and modify your 
terminal working environment. For instance, you can alter the proportion 
of the video screen devoted to command input (that is, the scrolled 
command region) by using the SCROLL= lines command parameter of the SET 
TERMINAL station command. The following example sets the command scroll 
region at 10 lines: 

CRAY> SET TERMINAL SCROLL=10<RET> 

Use the WIDTH=size command parameter of the SET TERMINAL station 
command to set the terminal width to either 80 or 132 characters. The 
following example sets the terminal width to 80 characters: 

CRAY> SET TERMINAL WIDTH=80<RET> 

Current information displayed on the terminal (CRT) is lost when you use 
the WIDTH command parameter. 

Use the REFRESH command parameter to move from refresh style Cray context 
and vice versa. The following example instructs the system to format 
your screen in refresh-style Cray context: 

CRAY> SET TERMINAL REFRESH < RET > 

See the Command Reference section for a detailed explanation of the SET 
TERMINAL station command. 



2.8.2 MOVING THROUGH A REFRESH-STYLE DISPLAY 

When you are in Cray context refresh style, a requested display may be 
too large for the available refresh display region. To page forward and 
backward in the display, use the + (page forward) and - (page backward) 
station commands. The + and - station commands have no affect in 
nonref resh-style command mode, since the entire display is delivered. 

You can remove the current display by requesting a different display or 
by using the CLEAR station command. 

When you are in Cray context command mode, you can specify whether all 
information or only one page of information is displayed by using the 
/CYCLE and /NOCYCLE command qualifiers. /CYCLE and /NOCYCLE are 
available with station commands that request a display, such as STATUS. 

If you include the /CYCLE command parameter and there is more than one 
page of information, the page number is automatically controlled, making 
it unnecessary to enter the + and - station commands. /NOCYCLE is the 
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default, indicating that only one page of the refresh-style display is 
shown until you enter the + or - commands. For example: 

CRAY> STATUS/CYCLE < RET > 

In this example, all STATUS display information is automatically cycled 
on your terminal screen. See the individual command descriptions for a 
more detailed discussion of the /CYCLE and /NOCYCLE command qualifiers. 



2.8.3 COPYING SCREEN DISPLAYS TO A VAX/VMS FILE 

When you are in Cray context command mode, you can save the latest 
display picture in a VAX/VMS file by using the SNAP command, followed by 
a VAX/VMS file specification. For example: 

CRAY> SNAP DISPLAY. DAT< RET > 

In this example, the latest display picture is copied into the VAX/VMS 
file DISPLAY.DAT. 



2.9 HANDLING INDIRECT STATION COMMAND FILES 

Within Cray context, you may create and execute indirect station command 
files. Such files contain a list of terminal input (usually commands) 
that can be carried out as if they were entered at the keyboard. 

You can create an indirect station command file by one of two methods: 

• From within Cray context, record a terminal session by using the 
RECORD command. All commands you enter at the keyboard are then 
stored in a VAX/VMS file. When you are finished recording the 
terminal session, enter RECORD/OFF after the CRAY> prompt. 

• Use a text editor to create the indirect station command file. 

For example, to create an indirect station command file that submits a 
job to the Cray Computer System and calls a status display, enter the 
following station commands inside a VAX/VMS file: 

SUBMIT GETPDS.J0B;3 
STATUS 



SV-0020 2-15 



You can create the same indirect station command file by entering the 
RECORD station command from within Cray context command mode, followed by 
a VAX/VMS file specification: 

CRAY> RECORD INDCOM. PLAY < RET > 

CRAY> STATUS < RET > 

CRAY> SUBMIT GETPDS. JOB; 3 <RET> 

''bCX-S-SUB^K, Job: CRAYJOB queued for submission 

CRAY> RECORD/ OFF < RET > 

CRAY> 

To execute the indirect station command file, enter the PLAY command, 
followed by the file specification of the indirect station command file: 

CRAY> PLAY INDCOM. PLAY < RET > 

You can use the COMMENT station command within the indirect station 
command file to insert comments that are displayed on your screen when 
you execute the file. In refresh command mode, use the PAUSE and DELAY 
commands for more time to observe refreshed displays. See the Command 
Reference section for more detailed information. 

In interactive mode, Cray Computer System prompts regulate the rate that 
new commands are delivered. 



2.10 USING COMMANDS IN VAX/ VMS COMMAND PROCEDURES 

VAX/VMS command procedures will help save you time when creating large or 
frequently run pieces of work. The Guide to Using Command Procedures on 
VAX/VMS, DEC publication AA-Y501A-TE, describes these command 
procedures. In command procedures, you must use the DCL-level form of 
VAX/VMS station commands. 

To test the final completion state, use the DCL command ON or the system 
global symbols $SEVERITY or $ STATUS . All station commands that execute 
normally complete in one of the following two states: 

• Success The completion status code is the VMS symbol SS$_NORMAL 

and results from success and informational messages. 

• Error The completion status code is the severe error code, VMS 

symbol SS$_ABORT and results from error messages. 

In the following example, command procedure THISPROC.COM, a SUBMIT 
command is tested. If the number of job submissions queued reaches the 
limit, an error status is returned. It is advisable to rerun the command 
procedure at a later time. 
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Example: 



$! This is THISPR0C.COM 

$! 

$ ON ERROR THEN GOTO RESUB 

$ CRAY SUBMIT MYFILE1.J0B 

$ 



$! Normal exit 

$ EXIT 

$! 

$RESUB: 

$ WRITE SYS$OUTPUT "THISPROC did not complete" 

$! Error exit 

$ EXIT 



2.11 SELECTING CRAY COMPUTER SYSTEMS 

At sites where more than one Cray Computer System is available, you can 
access Cray Computer Systems from a single VAX front end. This is 
accomplished by creating one VAX/VMS station, whether remote or attached, 
for each Cray Computer System to be accessed. You can change stations by 
entering the CHOOSE station command (see the Command Reference section). 

The CHOOSE command causes the execution of an installation-created 
VAX/VMS command procedure. The effect of this procedure is to redefine 
the CRAY station command. Each time you wish to change stations, the 
CHOOSE command must be reissued at DCL level. 

If you define your own synonyms for station commands (see subsection 
2.2), place these synonym definitions in a file named CXC0MMANDS.COM in 
your default login directory (i.e., SYS$LOGIN: CXC0MMAND.COM) . This will 
ensure that the synonym commands are redefined after a new CHOOSE command 
is issued. 
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SUBMITTING JOBS TO THE 
CRAY OPERATING SYSTEM 



This section describes how to submit your COS job files from the VAX 
Computer System to the Cray Computer System for processing. The section 
is divided into the following areas: 

• Preview of terminal job submission 

• Submitting COS jobs from your terminal 

• Examples of COS job submission 

• Job submission to COS from the VMS batch queue 

If you are a new user of the VAX/VMS station, see appendix A for two 
sample terminal sessions that draw together the skills discussed in this 
section and provide examples of preparing, submitting, and monitoring COS 
jobs. 



3.1 PREVIEW OF TERMINAL JOB SUBMISSION 

The process by which you prepare, submit, and monitor terminal jobs that 
are processed by COS is divided into three stages. Figure 3-1 describes 
this process. 



3.2 SUBMITTING COS JOBS FROM YOUR TERMINAL 

The first step in terminal job submission is to prepare a COS job file on 
the VAX Computer System. A COS job file is a collection of COS job 
control statements and, optionally, source code and data in the format 
required by COS. Figure 3-2 shows a typical COS job deck consisting of a 
control statement file, a source file, and a data file. The end-of-file 
<eof> separator as implemented by the VAX/VMS station is described with 
the SUBMIT command in the Command Reference section. 
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Use the VAX Computer System 
to prepare a file or files that 
will be submitted to COS. The 
first element in the job file must 
be Cray Job Control Language (JCL), 
which provides explicit instructions 
for COS on how to process the job. 
The job file or files you create on 
the front-end system can contain 
other elements, such as code and 
data to be used by the program. 

Use the SUBMIT station command to 
send the job file or files from the 
VAX Computer System to the Cray 
Computer System for processing. 
You can use other station commands 
to monitor and modify the job as 
it runs. Unless you request 
otherwise, output from the Cray job 
is returned to the VAX Computer 
System and placed in the directory 
from which the job was submitted. 

Use the VAX Computer System to 
manage the output from the submitted 
job. For example, you can read the 
file at your terminal, print a copy 
of it, or modify it for resubmission 
if it contains errors. 



Prepare your job on 
the VAX Computer 
System 



Submit your job to the 
Cray Computer System 
for processing 



Manage your COS job 
output on the VAX 
Computer System 



Figure 3-1. Steps in COS Job Preparation, 
Submission, and Management 



After you have prepared your COS job file on the VAX Computer System, you 
are ready to submit it to the Cray Computer System for processing. VMS 
terminal users submit COS jobs by using the SUBMIT station command. The 
minimum format of SUBMIT is quite simple, but can be made more specific 
with a number of available qualifiers and parameters. The basic SUBMIT 
format is: 



SUBMlT/gualifier <filel>( 1 + \<file2>) ... (\ + \<filen>) 



The Command Reference section describes this command and its qualifiers 
in detail. 
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JOB , JN= jobname . 

ACCOUNT. 

CFT. 

LDR. 

EXIT. 

/EOF 

J=50 

DO 10 1=1,10 

J=J+1 

PRINT 50, J 
10 CONTINUE 

STOP 
50 FORMAT ( ' ',13) 

END 
/EOF 
AAA 
BBB 
CCC 
DDD 
/EOF 



JCL Control Statement File 



]■ <eof> Separator 



Source File 



} <eof> Separator 



Data File 



Figure 3-2. Typical COS Job Deck 



If you use the SUBMIT station command, but do not include input file 
names, the station returns a prompt. For example: 

$ CRAY SUBMIT<RET> 
SUBMIT file(s): 

In reply to this prompt, type one or more VAX/VMS file names on the same 
line. If you type in more than one file name, you must separate the file 
by either commas (,) or plus signs (+). Plus signs indicate that you 
want COS to process a series of files as if it were a continuous file; 
commas separate each file by COS end-of-file separators. For example: 

$ CRAY SUBMIT<RET> 

SUBMIT f ile ( s ) : CRAYJOB1 . JOB+CRAYJOB2 . JOB<RET> 

In this station command, COS processes CRAYJOB1.JOB and CRAYJOB2.JOB as 
if they were a single file. If the two files are separated by commas, 
COS end-of-file separators are inserted automatically; COS processes them 
as separate files. 

You can also specify one file at a time in response to the the SUBMIT 
prompt, by entering a return after each file name. The prompt reappears 
for additional file names, until you enter <RET> only. For example: 
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$ CRAY SUBMIT<RET> 

SUBMIT files(s):CRAYJOBl.JOB<RET> 

SUBMIT files(s):CRAYJ0B2.J0B<RET> 

SUBMIT file(s):<RET> 

$ 

If you specify one file at a time, as previously shown, the station 
assumes that you intend each file to be processed separately. If you 
intend the files to be processed as one dataset, end each filename with a 
plus sign. 



3.3 COS JOB SUBMISSION EXAMPLES 

The following examples show three methods of constructing and submitting 
a COS job similar to that shown in figure 3-2. 



Example 1: 

In this example, a single job file contains the JCL file, source file, 
and data file. The /EOF command qualifier designates the COS end-of-file 
separator as four asterisks (****). 



$ CRAY SUBMIT/EOF="**** M CRAYJOB.JOB 

%CX-S-SUB_OK, Job: CREX1 queued for submission 
$ 



The VMS file CRAYJOB.JOB contains the following: 



J0B,JN=CREX1. 

ACCOUNT. 

CFT. 

LDR. 

EXIT. 

**** 

J=50 

DO 10 1=1,10 

J=J+1 

PRINT 50, J 
10 CONTINUE 

STOP 
50 FORMAT ( ' ',13) 

END 

AAA 
BBB 
CCC 
DDD 
**** 



JCL control statement file 



} <eof> separator 



Source file 



• <eof> separator 



• Data file 
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Example 2: 

In this example, the JCL file, source file, and data file are contained 
in separate VAX/VMS files and are staged to COS with a single SUBMIT 
station command. 

$ CRAY SUBMIT CRAY JOB. JOB, SOURCE. FOR, DATA. DAT 

%CX-S-SUB_OK, Job: CREX2 queued for submission 

$ 

CRAYJOB.JOB contains the following: 



JOB,JN=CREX2. 

ACCOUNT. 

CFT. 

LDR. 

EXIT. 



JCL control statement file 



SOURCE. FOR contains the following: 



J=50 

DO 10 1=1,10 

J=J+1 

PRINT 50, J 
10 CONTINUE 

STOP 
50 FORMAT ( ' ',13) 

END 



Source file 



DATA. DAT contains the following: 




Data file 



Example 3: 

In this example, the data file is entered at the terminal and the 
contents of CRAYJOB.JOB and SOURCE. FOR are identical to the contents of 
the files in example 2. 
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$ CRAY SUBMIT<RET> 

SUBMIT file: CRAY JOB. JOB < RET > 

SUBMIT file: SOURCE. FOR < RET > 

SUBMIT file: SYS$INPUT<RET> 

AAA<RET> 

BBB<RET> 

CCC<RET> 

DDD<RET> 

EEE<RET> 

Z 
SUBMIT file:<RET> 

%CX-S-SUB_OK, Job: CREX2 queued for submission 
$ 



Data file typed at terminal 



3.4 JOB SUBMISSION TO COS FROM THE VMS BATCH QUEUE 

The VMS batch and terminal users employ the same station command syntax 
to submit a job to COS. Since batch submission inhibits parameter 
prompting, any missing required parameters cause rejection of the job 
submission. Figure 3-3 is an example of the COS job deck for a job 
submission from a VMS batch stream. 

The VMS file CRAY1.JOB contains the COS JCL statements and the VMS file 
CRAY2.DAT contains the COS source file. 

If the VAX/VMS station cannot queue a CRAY SUBMIT request, it returns an 
error message. (See section 2 for details of testing final completion 
states. ) 

The JOB and PASSWORD cards are omitted if the VMS job is initiated from a 
VMS terminal session using the DCL SUBMIT command. 
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$EOJ 



DATA FILE 



$CRAY SUBMIT CRAY1. JOB, CRAY2 .DAT, SYS$ INPUT 



$ PAS SWORD 



$JOB SMITH 



Figure 3-3. COS Job Deck for Batch Job Submission 
from a Card Reader 
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MANAGING DATASETS 



This section discusses the management of datasets that are transferred 
between COS and the VAX front-end computer system. The following topics 
are addressed: 



Types of dataset staging 

Staging datasets to COS 

Staging datasets to VMS 

Identifying datasets 

Dataset formats 

VMS destination file types 

VMS source file types 

Dataset management defaults in the absence of a text parameter 

Dataset management defaults for jobs not originating from the 
station 



4.1 TYPES OF DATASET STAGING 

Staging is the process of transferring jobs and data in the form of COS 
datasets from the VAX front-end computer system to Cray mass storage or 
from Cray mass storage to the VAX front-end computer system. Staging is 
initiated by: 

• COS end-of-job processing 

• A specific request from a job running under COS 

• A job submitted to COS by the SUBMIT command 

• A SAVE station command, if available at your site 

COS jobs can use or create VAX/VMS files with the COS ACQUIRE, FETCH, and 
DISPOSE control statements. This section briefly describes each of these 
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job control statements; the COS Version 1 Reference Manual, CRI 
publication SR-0011, describes the statements in detail. Sections 5 and 
6 of this manual discuss specific VAX/VMS station parameters for ACQUIRE, 
FETCH, and DISPOSE statements. 



4.2 STAGING DATASETS TO COS 

Two control statements request staging of datasets from the VAX/VMS 
station to COS. ACQUIRE stages a dataset from the VAX/VMS station to COS 
and makes the dataset a COS permanent dataset. FETCH stages a dataset 
from the VAX/VMS station to COS and makes the dataset local to the job 
requesting it. This dataset is not made a COS permanent dataset. 



4.2.1 ACQUIRE PROCESSING 

The processing of the COS ACQUIRE control statement is as follows: 

1. If the dataset specified by the combination of pdn, id, and 
ed already exists as a COS permanent dataset, go to step 3. 

2. Request staging of the dataset from the VAX/VMS mainframe (mf) 
to create a COS permanent dataset. 

3. Make the permanent dataset local to the job with dataset name 
dn. 

Format: 



ACQUIRE, DN=dn,PDN=pdn,lD=uid,ED=ed,RT=r£,R=rd, 

W=wt,M=m21,UQ,TEXT=text,MF=mf : ,TID=tid,DF=df . 



DN=dn Dataset name consisting of 1 through 7 alphanumeric 
characters; required parameter. 

PDN=pdn Permanent dataset name consisting of 1 through 15 

alphanumeric characters assigned by the dataset creator; 
default is dn. 



!D=uid 



User identification 
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ED=ed Edition number of permanent dataset. Default is ED=1 if 
pdn does not exist; otherwise, ED is equal to the highest 
edition number. 

RT=rt Retention period in number of days. Installation-defined 
parameter. 

R=rd Read control word 

W=wt Write control word 

M=mn Maintenance control word 

UQ Unique access. Requests this job be sole user of pdn 

until released. UQ is required if the permanent dataset is 
to be deleted later in the job. 

TEXT=£ex£ Text to be passed to front-end system. The maximum size 
of text is 240 characters. See section 6 for details. 

MF=mf Mainframe identifier for the front-end computer; two 

alphanumeric characters. Default is mainframe of job 
origin. 

TID=£id Terminal identifier consisting of 1 through 8 alphanumeric 
characters. The default is the TID of originating job. 
This parameter should not be used for a request to the 
VAX/VMS station. 

DF=df Dataset format: 

CB Character blocked 
BB Binary blocked 
TR Transparent 

Default is CB. See subsection 4.5 for details of dataset 
formats . 



4.2.2 FETCH PROCESSING 

The processing of the COS FETCH control statement is as follows: 

1. Request staging of the dataset from the VAX/VMS mainframe (mf) 
to create a COS local dataset. 

2. Make the dataset local to the job with dataset name dn. 
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Format: 



I I 

| FETCH, DN=dn,SDN=.s'dn / TEXT= text / MF=fllf,TID=tid / DF=df . I 



DN=dn Dataset name consisting of 1 through 7 alphanumeric 
characters; required parameter. 

SDN=sdn Staged dataset name consisting of 1 through 15 alphanumeric 
characters; default is dn. 

TEXT=text Text to be passed to front-end computer system. The 

maximum size of TEXT is 240 characters. See section 6 for 
details and defaults. 

MF=mr" Mainframe identifier for VAX/VMS mainframe; 2 alphanumeric 
characters. The default is mainframe of job origin. 

TID=tid Terminal identifier consisting of 1 through 8 characters. 
The default is the TID of originating job. This parameter 
should not be used for a request to the VAX/VMS station. 

DF=df Dataset format: 

CB Character blocked 
BB Binary blocked 
TR Transparent 

Default is CB. See subsection 4.5 for details of dataset 
formats. 



4.3 STAGING DATASETS TO VMS 

The DISPOSE control statement requests staging of the COS dataset (dn) 
to the mainframe (mf) . 



Format: 



DISPOSE,DN=dn,SDN=sdn,DC=dc,DF=df,MF=mf,SF=s , f,lD=uid,TID=tid, 

ED=ed,RT=rt,R=rd,W=wt,M=inn,TEXT=text,| WAIT ), DEFER, NRLS. 

1 NOWAIT J 
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DN=dn Dataset name consisting of 1 through 7 alphanumeric 
characters; required parameter. 

SDN=5dn Staged dataset name consisting of 1 through 15 alphanumeric 
characters; default is dn. 

DC=dc Disposition code; default is PR: 

IN Place dataset in mainframe's input queue 

MT Write dataset to magnetic tape 

PR Print dataset 

PT Plot dataset 

PU Punch dataset 

SC Scratch dataset (no transfer occurs) 

ST Write dataset to disk 

DF=df Dataset format; default is CB: 

CB Character blocked 
BB Binary blocked 
TR Transparent 

MF=mf Mainframe identifier; default is mainframe of job origin. 

SF=sf Special forms information to be passed to front-end 

computer system 

ID=uid User identification 

TID=tid Terminal identifier; default is TID of originating job. 

This parameter should not be used when transferring to the 
VAX/VMS station. 

ED=ed Edition number; ignored by the VAX/VMS station. 

RT=r£ Retention period in the range is 1 through 4095. Default 
depends on destination mainframe. RT=r£ is used in 
specifying the expiration date for magnetic tape datasets. 

R=rd Read control word; ignored by the VAX/VMS station. 

W=w£ Write control word; ignored by the VAX/VMS station. 

M=mn Maintenance control word; ignored by the VAX/VMS station. 

TEXT=£ex£ Text to be passed to front-end computer system. The 

maximum size of TEXT is 240 characters. See section 5 for 
details. 
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WAIT Processing of the COS job is suspended until disposed 
dataset has been staged to front-end computer system. 

NOWAIT Processing of the COS job is resumed immediately. 

DEFER Defers disposition until dataset is released 

NRLS No release; dataset remains local to the COS job. 



4.4 IDENTIFYING DATASETS 

Datasets are identified on the Cray mainframe by the DN, PDN, ID, and ED 
fields of the ACQUIRE, FETCH, and DISPOSE control statements. 

The optional TEXT field contents identify the VMS file associated with a 
COS dataset. If the TEXT field is not specified, the defaults as 
described in subsection 4.8 apply. 

When the TEXT field is used, you must specify those components of a VMS 
file descriptor that uniquely identify that file. The VAX/VMS station 
supplies defaults for omitted file descriptor components. Sections 5 and 
6 discuss these defaults. 

The VAX/VMS station permits the use of VMS logical names for the full 
file descriptor. Logical name translation is performed when the VAX/VMS 
station receives the ACQUIRE, FETCH, or DISPOSE request; this requires 
the logical name to reside in the SYSTEM logical name table. 



******************************************************* 

CAUTION 

If a logical name for the file descriptor is used, the 
logical name equivalence must not change between the 
CRAY SUBMIT of the COS job and the ACQUIRE, FETCH, or 
DISPOSE being processed. If you assign the logical 
name to another VMS file, the VAX/VMS station uses the 
new equivalence. 

******************************************************* 



Although COS allows the TID field to be specified in the ACQUIRE, FETCH, 
or DISPOSE statements for VAX/VMS station use, the TID field should not 
be set. The VAX/VMS station uses this field for the VMS User 
Identification Code (UIC). 
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The VAX/VMS station does not use the SF=sf field; specifying sf has 
no effect. 



4.5 DATASET FORMATS 

The DF parameter in the ACQUIRE, FETCH, or DISPOSE control statements 
defines COS dataset formats. The VAX/VMS station supports character 
blocked (CB), binary blocked (BB), and transparent (TR) dataset formats 

The file organization and the VMS record format defines VMS file 
formats. The VAX/VMS station supports sequential, relative, and block 
file organizations. The supported record formats are fixed and 
variable. Table 4-1 shows the relationship between the various 
dataset/file formats. 



Table 4-1. COS Dataset to VMS File Mapping 



COS Dataset 
Format 


VMS File Organization 


Seq. 
Fixed 


Seq. 
Variable 


Relative 
Fixed 


Relative 
Variable 


Block 
Tape 


Block 
Disk 


CB 
BB 
TR 


+ 
+ 

X 


* 

* 

X 


+ 
+ 

X 


+ 
+ 

X 


+ 
+ 
* 




* 



+ Allowed 

O Not allowed 

* Default 

x Although allowed, these modes are extremely inefficient for 

transferring transparent data. (The user account is billed for all 

staging performed on their behalf.) 



4.5.1 COS CHARACTER BLOCKED DATASETS 

A CB dataset contains ASCII character data, block control words (BCWs), 
record control words (RCWs), and optional blank compression characters. 
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When the VAX/VMS station transfers a dataset to COS, it reads the VMS 
file, builds COS blocks by adding appropriate control words, and 
transmits the data in blocks to COS. 

When the VAX/VMS station receives a CB dataset from COS, it reads COS 
blocks, expands the compressed blanks, removes the RCWs to form VMS 
records, and writes the data to a VMS storage device. 



4.5.2 COS BINARY BLOCKED DATASETS 

The VAX/VMS station processes COS BB datasets the same as CB datasets, 
except that no blank expansion is performed. For BB datasets, be aware 
of the data reformatting performed by the Cray Computer System/VAX 
hardware link. Because the two systems address byte strings differently, 
the interface performs the following assembly/disassembly between 64-bit 
Cray words and 16-bit VAX words. Figure 4-1 shows the reformatting that 
occurs between the Cray system and the VAX. 

The manipulation required to present the binary data in the correct 
format to VMS or COS depends on the binary field width. The VAX/VMS 
station does not perform binary data manipulation. You must manipulate 
binary data to the correct format before sending a file to COS or after 
receiving a file from COS. 

As a special type of BB dataset, the VAX/VMS station can transfer 
magnetic tape files in a special format called interchange format, 
which is specified by the /FOREIGN qualifier in the DISPOSE, ACQUIRE, or 
FETCH TEXT field. (See subsections 5.3.1 and 6.3.1.) This format 
facilitates reading and writing of tapes that are also to be read or 
written on tape devices connected to other vendors' systems or to a CRI 
I/O Subsystem (IOS). In interchange format, each tape block of data 
corresponds to a single logical record in COS blocked format. See the 
COS Version 1 Reference Manual, publication SR-0011, for further 
information on interchange format. 



4.5.3 COS TRANSPARENT DATASETS 

A transparent dataset consists of a bit string. The VAX/VMS station 
performs no reformatting. 



4.5.4 VMS SEQUENTIAL FILE ORGANIZATION 

The sequential file organization is supported for all device types. 
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Figure 4-1. Blocked Data Reformatting 



4.5.5 VMS RELATIVE FILE ORGANIZATION 

A relative file is a series of fixed-length positions (or cells) 
consecutively numbered from 1 to n. This number is the record number 
relative to the beginning of the file. 

The VAX/VMS station allows only sequential access of records from a 
relative file. 



4.5.6 VMS BLOCK MODE PROCESSING 

In block mode/ data is organized sequentially in data lengths equal to 
the physical block size of the VMS device. For disk devices this length 
is 512 bytes; for magnetic tape devices the station supports block sizes 
from 14 bytes to 32,768 bytes. VMS block mode is the fastest method of 
transferring data between the Cray mainframe and the VAX system. 
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4.6 VMS DESTINATION FILE TYPES 

For datasets being staged from COS to VMS, the disposition code (DC) on 
the DISPOSE statement and the staging command element in the TEXT field 
determines the VMS destination device type or symbiont. The disposition 
codes supported are: 

DC Description 

IN Dispose to a VMS batch queue 

MT Dispose to a VMS magnetic tape 

PL Dispose a COS plot dataset to a VMS disk file 

PR Dispose to a VMS print queue 

PU Dispose a COS punch dataset to a VMS disk file 

ST Dispose to a VMS disk file 

The staging commands supported are: 

Staging Command Description 

$SUBMIT Dispose to a VMS batch queue 

$DISK Dispose to a VMS disk file 

$TAPE Dispose to a VMS magnetic tape 

$PRINT Dispose to a VMS print queue 

$USER=nn Dispose to an installation specific device 

Section 5 describes the use of the disposition code and the staging 
command . 



4.7 VMS SOURCE FILE TYPES 

For datasets being staged from VMS to COS, the staging command element in 
the ACQUIRE or FETCH TEXT field determines the source device type. 

The staging commands supported are: 

Staging Command Description 

$DISK Acquire from a VMS disk file 

$TAPE Acquire from a VMS magnetic tape 

$USER=nn Acquire from an installation specific device 

Section 6 describes the use of the ACQUIRE and FETCH staging commands. 
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4.8 DATASET MANAGEMENT DEFAULTS IN THE ABSENCE OF A TEXT PARAMETER 

If you do not specify a TEXT field in a COS ACQUIRE, FETCH, or DISPOSE 
control statement, the VAX/VMS station uses certain default parameters. 
COS can automatically return datasets with disposition code PR to the 
VAX/VMS station without specific DISPOSE statements. These datasets are 
treated the same as a DISPOSE with DC=PR and no TEXT parameter. The 
following subsections discuss VAX/VMS station defaults. 



4.8.1 DISPOSE DEFAULTS FOR DC=PR 

When PR datasets are returned to the VAX/VMS station, the station either 
prints the files or creates VMS disk files that you can view from a VMS 
terminal. The /[NO]PRINT qualifier on the station SUBMIT command 
determines the type of processing. See the command section for 
information on the /[NO]PRINT qualifier. 

If you use the default /NOPRINT, the VAX/VMS station creates a VMS file 
with the following format: 

(User's default directory) ( < filename* .CPR; < version number>) 



User's default directory 

The disk and directory from where the Cray job was submitted 

filename COS job name which generated the $OUT 

CPR File type indicating the file is COS print file output 

version number 

If the file filename already exists, the station creates 
the file with the existing version number plus 1. 

A DISPOSE control statement with the $PRINT staging command specified in 
the TEXT field can be used to override a /NOPRINT SUBMIT qualifier. See 
section 5 for more information concerning the DISPOSE statement TEXT 
field. 

To print COS $OUT, the station uses the logical print queue SYS$PRINT. 
The Process Local Logical Name Table for the user issuing the station 
SUBMIT command defines SYS$PRINT. Print output can be routed to any VMS 
print queue using the $PRINT staging command. See section 5 for more 
information about the $PRINT staging command. 
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4.8.2 DISPOSE DEFAULTS FOR DC=ST,PL / PU,MT 

Disposition code MT does not have a default since a TEXT parameter is 
required for magnetic tape staging. As the default for all other 
disposition codes, the station creates a file with the following format: 



(User's default directory) ( < filename* .Cdc; < version number*) 

User's default directory 

The disk and directory from where the Cray job was submitted 

filename sdn 

Cdc File type indicating the file staged: 

CST if DC=ST 
CPL if DC=PL 
CPU if DC=PU 

version number 

If the file filename already exists, the station creates 
the file with the existing version number plus 1. 

Several DISPOSE default examples follow. 

Example 1: 

DISPOSE, DN=MYFILE,DC=ST. 

This statement creates a VMS file in the device and directory from which 
the job was submitted with the file name MYFILE.CST;1, assuming that you 
did not have an existing file named MYFILE.CST. The protection 
attributes for the file are as specified for your UIC process by the DCL 
SET PROTECTION command. Since DF is not specified, the VAX/VMS station 
creates a VMS sequential file with variable length records. 

Example 2 : 

DISPOSE, DN=MYFILE,DC=PL,DF=BB. 

This command creates MYFILE.CPL; 2 in the device and directory from which 
the job was submitted, assuming that MYFILE.CPL version 1 already 
exists. The file organization for MYFILE.CPL; 2 is sequential and records 
within the file are of variable length. 
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If DF is transparent, the VMS file is written in 512-byte blocks. 
Because this file has had no processing to remove the COS record 
structure, it cannot be subsequently read using the Record Management 
Services (RMS) GET function. This mode is used normally for archiving 
Cray mainframe mass storage to VMS disk files. 



Example 3: 

DISPOSE , DN=MYFILE , DC=ST, DF=TR . 

This command creates MYFILE.CST;2 using RMS block mode WRITES. This file 
can be restaged to COS by the following ACQUIRE statement (provided that 
both jobs are submitted from the same disk and directory) : 

ACQUIRE, DN=MYF I LE, DF=TR. 



4.8.3 ACQUIRE/FETCH DEFAULTS 

The only ACQUIRE parameter affecting the staging of datasets to COS is 
the dataset format. The file name in your default directory defaults to: 

pdn. CST; < highest existing version number) 

If DF is character blocked or binary blocked, the station uses the file 
organization and record type as defined for the file. For example, 

ACQUIRE,DN=MYFILE,DF=CB. 

This statement creates the COS permanent dataset MYFILE using the highest 
version of MYFILE. CST in your default device and directory. The station 
reads records sequentially from the file and blocks them into COS blocked 
format (indexed sequential not allowed). Blocking is performed when the 
data is transferred to the Cray mainframe. If DF is transparent, the 
station uses block I/O to read 512-byte VMS blocks. No COS record 
blocking is performed. 

The FETCH default is: 

sdn. CST; < highest existing version number> 
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4.9 DATASET MANAGEMENT DEFAULTS FOR JOBS NOT ORIGINATING FROM THE STATION 

When a COS job is submitted from the VAX/VMS station, control information 
relating to the user submitting the COS job and the station environment 
is included. If you define the default print queue, COS routes print 
datasets without the station control information to this queue. Other 
datasets are staged to or from the station default device and directory. 

If a job originating from some other station makes an ACQUIRE or DISPOSE 
request to the VAX/VMS station, the TEXT field of the request must 
specify a complete VMS file specification including the DECnet nodename 
and username/password information. This is mandatory to protect VMS file 
security. 
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DISPOSE FACILITIES 



The COS DISPOSE control statement stages datasets from Cray mainframe 
mass storage to VMS files. Section 4 provides the general format of the 
DISPOSE control statement. Specific DISPOSE parameters used by the 
VAX/VMS station are as follows: 

Parameter VAX/VMS Station Usage 

dn See staged dataset name (sdn) 

sdn If the VMS file name is not specified in the TEXT field, 

this parameter is the default VMS file name. If this 
parameter is not specified on the DISPOSE statement, the 
default is dn. 

dc One of the following disposition codes: 

IN Dataset entered in VMS batch queue 

MT Dataset staged to VMS magnetic tape 

PL Dataset staged to VMS disk file 

PR Dataset entered in VMS print queue 

PU Dataset staged to VMS disk file 

ST Dataset staged to VMS disk file 

mf Mainframe identifier of the VAX/VMS station 

tid Used internally by the VAX/VMS station. This parameter 

should not be specified by users. 

r£ Retention period in days for a magnetic tape file; range, 
through 4095. (See /EXPIRY qualifier in subsection 
5.3.1) 

df One of the following dataset formats: 

CB VAX/VMS station deblocks COS dataset and expands 
blank compression characters. 

BB VAX/VMS station deblocks COS dataset. 

TR VAX/VMS station treats COS dataset as a bit string. 
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5.1 DISPOSE TEXT FIELD CONTENTS 

The DISPOSE TEXT field contains an ASCII string of up to 240 characters. 
When specified, the staging command and file descriptor must separated by 
one or more spaces. 



Format: 



($<staging command> (/< command qualifiers*)) 
(<file descriptor* (/ <f He qualifiers*)) 



staging command 

Optional element identifying the target device or symbiont 
for datasets staged from COS to the VAX/VMS station. Table 
5-1 summarizes all available staging commands. 

If the staging command specified in the TEXT field is 
inconsistent with the DC parameter setting, the DC 
parameter is overridden. 

If you do not specify a staging command, the defaults are 
as follows: 



DISPOSE DC Parameter 

IN 
PR 
ST,PL,PU 



Staging Command 

$ SUBMIT 

$PRINT 

$DISK 



MT does not default to $TAPE because the command 
qualifier is required for magnetic tape staging. 

/command qualifiers 

Optional element consisting of zero or more qualifiers, 
each with the general form /QUAL[=< value* ] . The command 
qualifiers are specified only if a staging command is 
specified. The individual staging command sections 
describe the qualifiers used. 
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file descriptor 

Optional element consisting of a standard VMS file 
specification uniquely identifying the target file on the 
specified device type 

/file qualifiers 

Optional element consisting of zero or more qualifiers each 
with the general form /QUkL[=<value> ] 



Table 5-1. DISPOSE Staging Commands 



Command 


Description 


Subsection 


$DISK 


Stages to VMS disks 


5.2 


$TAPE 


Stages to VMS tapes 


5.3 


$ SUBMIT 


Stages to VMS input queue 


5.4 


$PRINT 


Stages to VMS print queue 


5.5 


$USER=nn 


Installation specific 


5.6 



5.2 $DISK DISPOSE STAGING COMMAND 

The $DISK staging command stages COS datasets to disk-resident VMS 
files. If the DC parameter in the COS DISPOSE statement is set to ST, 
PL, or PU and no staging command qualifiers are required, $DISK need not 
be specified. 



Format: 



($DlSK(/< command qualifiers>)) 

(<file descriptor>(/<file qualifiers))) 
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5.2.1 $DISK COMMAND QUALIFIERS 



The following $DISK command qualifiers qualify the $DISK staging command: 



Qualifier 
/TRNC 



/EOF= <eof> 



/RMS= ( REC 
BLK 



Description 

The station truncates any records received 
from COS exceeding the VMS file maximum 
record length (see /MRS file qualifier) to 
the VMS maximum record length. If you do 
not specify the /TRNC qualifier and the 
station detects an illegal length record, 
the system cancels the DISPOSE and a message 
is issued in the job log. 

<eof> specifies a 1- to 80-character ASCII 
string that is inserted in the VMS target 
file when the station detects a COS EOF 
separator. If you do not specify this 
qualifier, the system uses the station 
default EOF separator. 

Specifies the mode of operation for writing 
records to VMS files. The default is 
installation dependent and is set by the 
VAX/VMS station manager. 

REC Records are written using RMS. RMS 
record transfers across DECnet are 
restricted to 16,384 bytes. 

BLK The station writes and blocks the 

records. If this mode is used, the 
LRL field is not set in the file 
header. 



5.2.2 $DISK FILE DESCRIPTOR 

The file descriptor element format is as follows: 

(< node" user name password" >: : )( <dev> : )( [<directory>] ) 
(<filename>) ( . <type>) (;<version>) 
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node"username password" : : 

Specifies the standard DECnet node name for the target VAX 
node, together with a valid username and password pair; 
required only for requests from jobs that did not originate 
from the target VAX. username and password must be 
enclosed in double qoutes and separated by one space. 



dev 



Standard VMS device name of one the disk devices supported 
by the VAX running the VAX/VMS station 



directory Standard VMS directory 

filename Standard VMS file name 

type Standard VMS file type 

version Standard VMS file version number 

See the VAX/VMS DCL Dictionary, DEC publication AA-Z200A-TE, for a full 
description of the $DISK file descriptor format. Logical names can be 
used in place of the device and directory components of the file 
descriptor or in place of the whole file descriptor. The VAX/VMS DCL 
Dictionary describes logical names in general, as does section 4 of this 
manual . 

Defaults are supplied for missing components as follows: 

Parameter Default 



node"username password":: 



dev: [<directory>] 

filename 

type 

version 



Standard DECnet node name, username, and 
password for the target VAX node is required 
only if the request is from a job that was 
not submitted from the target VAX. 

If the device component is missing, the 
station uses the disk and directory from 
where the job was submitted. 

The default filename is the DISPOSE sdn. 

Cdc 

Default is the highest existing version 
number for the file plus 1. 
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The following five examples illustrates the use of the $DISK file 
descriptor: 

DISPOSE, DN=MYFILE,DC=ST. 

DISPOSE, DN=MYFILE,DC=ST,TEXT= , $DISK' . 

DISPOSE, DN=MYFILE,DC=ST,TEXT=' MYFILE; 3' . 

DISPOSE, DN=MyFILE / TEXT='$DISK DBA2 : [MYDIRJMYFILE.CST; 3 ' ,DC=ST. 

DISPOSE, DN=MYFILE,DC=ST / TEXT=' FRED' . 

All five examples achieve the identical result: the COS dataset MYFILE 
is disposed to the VMS file MYFILE. CST on device DBA2, in directory 
MYDIR, with version number 3. The following assumptions are made: 

• The file DBA2: [MYDIR ]MYFILE. CST; 2 already exists. 

• The job was submitted from DBA2: [MYDIR] . 

• The logical name translation for FRED in the system Logical Name 
Table is DBA2: [MYDIRJMYFILE.CST; 3 . 



5.2.3 $DISK FILE QUALIFIERS 

File descriptor qualifiers construct the RMS file access block (FAB) 
before the station accesses the file. See the VAX Record Management 
Services Reference Manual, DEC publication AA-Z503A-TE, for further 
details on FABs. The system recognizes the following qualifiers: 



Qualifiers 

/ PROTECTION <prop£> 



Description 

VAX/VMS station file protection is specified 
in the same way as VMS file protection 
specifications. They may have the following 
components : 

WORLD: <opt> Set world access protection 

GROUP: <op£> Set group access protection 

OWNER: <op£> Set owner access protection 

SYSTEM: <opt> Set system access protection 
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Qualifiers 



Description 
<opt> 



Access option; any combination 
of the following access codes 
where a specified code grants 
access: 



R Read access 

W Write access 

E Execute access 

D Delete access 

The default file protection is based on the 
user's process at the time of job 
submission, which can be changed by the DCL 
command SET PROTECTION. Specify multiple 
attributes by separating the attributes with 
commas and enclosing them in parentheses. 
For example: 



/ORG= 



BLK 
SEQ 
REL 



/PROTECTION ( S : RW, GR : R , WORLD ) 

This protection qualifier allows the system 
read and write access and group members read 
access only; prohibits access by all users 
in the world category and does not change 
the current access for the owner. 

Target file organization is as follows: 

BLK File is written in block mode; 

default for COS dataset format TR. 

REL Records are written sequentially to 

an RMS relative-record file (starting 
at relative record number 1). 

SEQ Records are written sequentially to 
an RMS sequential access file; 
default for COS dataset formats CB 
and BB. 



/RFM= | FIX 
VAR 



Type of record file. This field is ignored 
if /ORG=BLK is specified. 



FIX Fixed-length record format 

VAR Variable-length record format. This 
is the default RFM. 
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Qualifiers Description 



NOTE 

If the record received from COS is 
less than the MRS and the format is 
fixed, the VMS record is padded 
with blanks. 



/MRS-<max_rec_size> Maximum record size for the file is as 

follows: 

• For fixed-length records, specifies the 
actual size of each record in the file. 
This field must be specified if 
/RFM=FIX. 

• For variable-length /ORG=SEQ records, 
the value represents the size of the 
largest record that can be written to 
the file. If MRS is not specified, 
there is no user limit on record size. 

• For relative files this value 
determines the size of the record 
cell. This is a mandatory parameter if 
/ORG=REL is specified. 



/RAT= JCR 1 Specifies whether control information 

l FTN J pertaining t 

/NORAT initialized. 



l FTN J pertaining to the records in the file is 



CR Indicates each record is to be 

preceded by a line feed and followed 
by a carriage return when the record 
is written to a carriage control 
device such as a terminal or line 
printer. 

FTN Indicates that the first byte of each 
record contains a FORTRAN (ASA) 
carriage control character. This is 
the default RAT. 

/NORAT creates a file with no record 
attributes. 
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The following example shows a dataset disposed to VMS disk. 

DISPOSE,DN=CRYFILE,DF=CB,TEXT='$DISK/TRNC DBA1: [MYDIR] VAXFILE.DAT 
/PROT=(0:RWD / G:R)/ORG=REL/RFM=FIX/MRS=132 ' . 

In this example, 
DN=CRYFILE 



DF=CB 
$DISK 

/TRNC 
DBA1: 



COS dataset name 

COS dataset format is character blocked. 

Destination VMS file is disk resident. 

If any records in the COS dataset exceed the maximum record 
size (132), the VMS records are truncated to the specified 
/MRS value. 

Physical device name where the VMS file VAXFILE.DAT is 
created 



[MYDIR] VMS file VAXFILE.DAT is entered in the directory MYDIR on 
device DBA1. 

VAXFILE.DAT 

VMS file name uniquely identifying the file within the 
directory MYDIR 

/PROT=(0:RWD,G:R) 

Protection qualifier that provides group members read 
access only; provides the owner with read, write, and 
delete access; and provides the process default protection 
for the system and world categories. 

/ORG=REL VMS file VAXFILE.DAT is relative organization. 

/RFM=FIX VMS file VAXFILE.DAT contains fixed-length records. 

/MRS=132 VMS VAXFILE.DAT contains fixed-length 132 byte records. 
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5.3 $TAPE DISPOSE STAGING COMMAND 

The $TAPE staging command stages COS datasets to magnetic tape resident 
VMS files. $TAPE is mandatory for magnetic tape staging. The VAX/VMS 
station supports those magnetic tape structures defined by American 
National Standards Institute standard ANSI X3. 27-1977 and also tapes in 
interchange format (see subsection 4.5.2). 



Format: 



| $TAPE/< command qualifiers (<file descriptors (/<f He qualifiers)) \ 

I I 



5.3.1 $TAPE COMMAND QUALIFIERS 

The following command qualifiers are recognized when the DISPOSE 
destination device is magnetic tape. /VOLUME is the only required 
command qualifier. 



Qualifiers 

/ VOLUME =<volnam> 



Description 

Volume name (label) or names for a 
multivolume tape set; required qualifier. 
Maximum 6 characters. The station appends 
the disposed dataset after the last file 
already on the volume set. If the dataset 
exceeds the volnam list, the operator must 
provide a volume name. Both the COS job log 
and the station logfile records the name 
supplied. Specify multiple volumes by 
separating the volumes with commas and 
enclosing them in parentheses. 



/BLOCKSIZE=<n> 



Block size of the magnetic tape that is to 
be written; optional qualifier. n is an 
integer in the range 14 to 32,768 specifying 
the block size in bytes. The default for 
this qualifier is 4096. For interchange 
format, this specifies the maximum tape 
block size. 
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Qualifiers 
/EOF= <eof> 



/ expiry =<date> 



Description 

<eof> specifies a 1- to 80-character ASCII 
string that is inserted in the VMS target 
file when the station detects a COS EOF 
separator; optional qualifier. If you do 
not specify this qualifier, the station uses 
the station default EOF separator. 

Expiration date for a magnetic tape file; 
optional qualifier. The format of this 
field is either: 



/FOREIGN 



/TRNC 



/RMS= 



BLK 
REC 



• dd-mmm-yyyy , a standard VMS date; 
default is the current date. 

• +nnnn, where nnnn is an integer 

from 1 to 9999, specifying the number 
of days after the current date before 
expiration. Default is the RT 
parameter of the DISPOSE statement. 

Required for an interchange format tape; 
optional qualifier. 

The station truncates any records received 
from COS exceeding the VMS file maximum 
record length (see /MRS file qualifier) to 
the VMS maximum record length; optional 
qualifier. If you do not specify the /TRNC 
qualifier and the station detects an illegal 
length record, the station cancels the 
dispose. 

Specifies the mode of operation for writing 
records to VMS files; optional qualifier. 
The default is installation dependent and is 
set by the VMS station manager. 

BLK The station writes and blocks the 

records. If this mode is used, the 
LRL field is not set in the file 
header. 

REC Records are written using RMS. 
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Qualifiers Description 

/UNLOAD The volume is physically unloaded from the 

/NOUNLOAD tape unit when staging is complete; optional 

qualifier. 

/REWIND The volume is rewound but not unloaded at 

the end of the transfer; optional qualifier. 

/OVERWRITE The volume is rewound and the data is 

written at the beginning of the tape; 
optional qualifier. 



5.3.2 $TAPE FILE DESCRIPTOR 

The file descriptor element format is: 



I I 

| (<dev>:)(<filename>)(.<type>) \ 



dev Standard VMS device name of one of the magnetic tape 

devices supported by the VAX running the VAX/VMS station, 
If the controller or unit number is not specified, an 
available unit on that device is selected automatically. 

filename Standard VMS file name 

type Standard VMS file type 

Both filename and type can be replaced by 1 to 17 ASCII character 
ANSI file name delimited by quotes, as in "ANSI TAPE FILE." 

Defaults supplied for missing components are as follows: 

Parameter Default 

dev The default tape device is determined by the VAX/VMS 

station manager. 

filename The default for the file name is the DISPOSE sdn 

parameter. 

type CMT 



SV-0020 5-12 



5.3.3 $TAPE FILE QUALIFIERS 

The following qualifiers are recognized: 

Qualifiers Description 

/MRS= <max_rec_size> Maximum record size for the file as follows: 

• For fixed-length records, specifies the 
actual size of each record in the file. 
This field must be specified if 
/RFM=FIX. 

• For variable-length /ORG=SEQ records, 
the value represents the size of the 
largest record that can be written to 
the file. If MRS is not specified, 
there is no user limit on record size. 

• For relative files, this value 
determines the size of the record 
cell. This is a mandatory parameter if 
/ORG=REL is specified. 

• For interchange format tape files, this 
parameter is ignored since the record 
size is equal to the block size. 

/ORG=| BLK | Target file organization as follows: 

ISEQl 

BLK File is written in block mode; 

default for COS dataset format TR. 

BLK must be specified for interchange 

format tapes. 
SEQ Records are written sequentially to 

an RMS sequential access file; 

default for COS dataset formats CB 

and BB. 

/PROTECTION <propt> VAX/VMS station file protection is specified 

in the same way as VMS file protection 
specifications. They may have the following 
components : 

WORLD: <opt> Set world access protection 
GROUP: <opt> Set group access protection 
OWNER: <opt> Set owner access protection 
SYSTEM: <opt> Set system access protection 
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Qualifiers 

/PROTECTIONS prop £> 
(continued) 



Description 
<opt> 



Access option; any combination 
of the following access codes 
where a specified code grants 
access: 



/RFM= ( FIX 
VAR 



R Read access 

W Write access 

E Execute access 

D Delete access 

The default file protection is based on the 
user's process at the time of job 
submission, which can be changed by the DCL 
command SET PROTECTION. Specify multiple 
attributes by separating the attributes with 
commas and enclosing them in parentheses. 

Type of record access for file. This field 
is ignored if /ORG=BLK is specified. 

FIX Fixed-length record format, ANSI F 
type format 

VAR Variable-length record format, ANSI D 
type format 



5.4 $SUBMIT DISPOSE STAGING COMMAND 

The $SUBMIT DISPOSE staging command stages the dataset from COS to a VMS 
disk file and then submits that file to a VMS batch queue. 



Format: 



$SUBMlT(/< command qualifiers*) 

(<file descriptor* (/<f He qualifiers*)) 
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5.4.1 $SUBMIT COMMAND QUALIFIERS 

In addition the $DISK command qualifiers (subsection 5.2.1), the 
following optional $SUBMIT command qualifiers are recognized: 



Qualifiers 

/ AFTER=absolute-time 



Description 

Indicates the job is held until a specified 
time. If that time has already passed, the 
job is queued for immediate processing. 
Specify the time value according to the 
rules for entering absolute times. See 
VAX/VMS DCL Dictionary, DEC publication 
AA-Z200A-TE, for more information. 



/CPUTIME=n 



Indicates CPU time limit for the batch job. 
The parameter n can be specified as a 
delta time, the value 0, or the words NONE 
or INFINITE. Default is established by the 
batch queue. 



/HOLD 
/NOHOLD 



Specifies whether the job is available 
for immediate processing. If /HOLD is 
specified, the job is not released for 
processing until specifically released with 
the DCL SET QUEUE/RELEASE command. The 
default is /NOHOLD. 



/IDENTIFY 
/NOIDENTIFY 



/KEEP 
/NOKEEP 



/LOG_FlLE=f ile-spec 

/NOLOG FILE 



Specifies whether the system displays the 
job number and batch queue name when it is 
successfully queued. By default, the job 
number and batch queue names are displayed. 

Specifies whether the logfile is deleted 
after it is printed; default is /NOKEEP. 

Specifies whether a specified logfile is 
created for the job. By default, the 
logfile is written to a file into the user's 
default directory having the same name as 
the command file and a file type of LOG. If 
the /LOG_FILE qualifier is omitted and the 
/NAME qualifier is specified, the logfile is 
written to a file having the same name as 
that specified by the /NAME qualifier. In 
this case, the name specification on the 
/NAME qualifier must be a valid file 
specification. If /NOLOG_FILE is specified, 
the logfile is written to a null device. 
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Qualifiers 
/name = j ob- name 



/NOTIFY 
/NONOTIFY 



/PARAMETERS=parameter5 



/PRlNTER=gueue-name 
/NOPRINTER 



/PRIORITY=n 



/REMOTE 



/ QUEUE =queue-name 



Description 

Indicates 1 to 8 alphanumeric character name 
string identifying the job. The job name is 
displayed by the DCL SHOW QUEUE command and 
is printed on the flag page of the batch job 
output log, replacing the file name of the 
logfile. If /NAME is not specified, the 
file name (truncated to 8 characters, if 
necessary) is the default. 

Controls whether a message is broadcast to a 
terminal on which the user is logged on 
notifying the user that the VMS job is 
complete or aborted. Default is NONOTIFY. 

Indicates 1 to 8 optional parameters to be 
passed to the job. The parameters define 
values equated to the symbols named PI, P2, 
P3, and so on, in each command procedure in 
the job. The symbols are local to the 
specified command procedures. 

If more than one parameter is specified, 
separate with commas and enclose in 
parentheses. To specify a parameter that 
contains special characters or delimiters, 
enclose the parameter in quotation marks. 

Controls whether the job log is queued for 
printing when the job is complete. The 
/PRINTER qualifier allows the specification 
of a particular print queue. By default, 
the job log is printed on SYS$PRINT. 

Specifies the VMS priority at which the 
batch job is entered on the queue. Valid 
range is through 2 55, with the lowest 
priority being 0. 

Indicates that the dataset is to be entered 
on the batch queue of a remote node. The 
file descriptor must contain the remote node 
name as specified in subsection 5.2.2. 

Indicates the VMS batch queue to which the 
job is submitted; by default, the job is 
submitted to the SYS$BATCH queue. 
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Qualifiers 
/WSDEFAULT=n 



Description 

Defines a working set default for the batch 
job. The parameter n can be a positive 
integer in the range 1 through 65535, 0, or 
the word NONE. 



/WSEXTENT=n 



Defines a working set extent for the batch 
job. The parameter n can be a positive 
integer in the range 1 through 6 553 5, 0, or 
the word NONE. 



/WSQU0TA=n 



Defines the maximum working set size, or the 
working set quota, for the batch job. The 
parameter n can be a positive integer in 
the range 1 through 6553 5, 0, or the word 
NONE. 



5.4.2 $SUBMIT FILE DESCRIPTOR 

The format for the $SUBMIT file descriptor is identical to the $DISK file 
descriptor element format described in subsection 5.2.2. 



5.4.3 $SUBMIT FILE QUALIFIERS 

The file qualifiers, as defined for $DISK file qualifiers (subsection 
5.2.3), apply to the $SUBMIT staging command. In addition, the $SUBMIT 
staging command recognizes the following optional file qualifier: 



Qualifier 

/DELETE 
/NODELETE 



Description 

File is to be deleted after the $SUBMIT has 
been processed. The protection code on the 
file must allow delete access to the user 
who submitted the COS job with the DISPOSE 
request. Default is /NODELETE. 



5.5 $PRINT DISPOSE STAGING COMMAND 

The $PRINT DISPOSE staging command indicates that the dataset staged from 
COS is first placed in a VMS disk-resident file and then submitted to a 
VMS print queue. 
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Format: 



$PRlNT(/< command qualifiers>) 

(<file descriptor>(/<file qualifiers*)) 



5.5.1 $PRINT COMMAND QUALIFIERS 

In addition to the $DISK command qualifiers (subsection 5.2.1), the 
following $PRINT command qualifiers are recognized. 



Qualifiers 

/ hFTER=absolute-time 



/CHARACTERISTICS^ C[ 



/DEVlCE=device-name 



/FORM= type 



/HOLD 
/NOHOLD 



Description 

File is not printed until a specific time. 
Specify time using the standard VMS syntax 
rules for absolute time values. (See the 
VAX/VMS DCL Dictionary, DEC publication 
AA-Z200A-TE, for rules.) If the specified 
time has passed, the file is queued for 
printing. 

]) 
Specifies one or more characteristics 
desired for printing the file. To specify 
more than one characteristic, separate with 
commas and enclose the list in parentheses. 
Characteristics codes are installation 
defined. 

File is to be queued for printing on a 
specific device. If you do not specify 
/DEVICE, default is the user's default 
SYS$PRINT. This qualifier is synonymous 
with the /QUEUE qualifier. 

Forms type required; use installation-defined 
numeric value or alphanumeric code. 

Specifies if file is available for printing 
immediately. If you specify /HOLD, the 
system does not release the file for 
printing until the DCL SET QUEUE/RELEASE 
command is issued. The default is /NOHOLD. 
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Qualifiers 



Description 



/LOWERCASE 
/NOLOWERCASE 



File contents. If the file contains 
lowercase alphabetic letters, it must be 
printed on a printer that prints uppercase 
and lowercase letters. Use /NOLOWERCASE for 
uppercase only printers. 



/ NAME = j ob- name 



Indicates 1 to 8 alphanumeric character job 
name string. The job name is displayed by 
the DCL SHOW QUEUE command and is printed in 
the top and bottom rows of the flag page. 
If you do not specify /NAME, the default is 
the file name (truncated to 8 characters, if 
necessary) . 



/NOTIFY 
/NONOTIFY 



Controls whether a message is broadcast to a 
terminal on which the user is logged on, 
notifying the user that the PRINT VMS job is 
complete or aborted. 



/PRIORITY=n 



Specifies the VMS priority at which the 
print job is entered on the queue. Valid 
range is through 2 55, with the lowest 
priority being 0. 



/QUEUE=gueue-name 



File is to be printed on a specific device. 
This qualifier is synonymous with the 
/DEVICE qualifier. If not specified, the 
default is the user's default SYS$PRINT 
queue . 



/REMOTE 



Indicates that the dataset is entered on the 
print queue of a remote node. The file 
descriptor must contain the remote node name 
as specified in subsection 5.2.2. 



5.5.2 $PRINT FILE DESCRIPTOR 

The format for the $PRINT file descriptor is identical to the $DISK 
descriptor element format described in subsection 5.2.2 
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5.5.3 $PRINT FILE QUALIFIERS 

The $PRINT file qualifiers are the same as the $DISK file qualifiers 
(subsection 5.2.3). In addition, the $PRINT staging command recognizes 
the following optional file qualifiers: 



Qualifiers 



Description 



/BURST 
/NOBURST 



Specifies if burst page is included on 
output. A burst page precedes a flag page 
and contains the same information; however, 
it is printed over the perforation between 
pages. This qualifier overrides the 
installation-defined defaults set up for 
printers. The default is /NOBURST. 



/COPIES=n 



Indicates the number of copies to print. 
Range is 1 to 255; default is one copy. 



/DELETE 
/NODELETE 



Specifies if file is deleted after 
printing. The file protection must allow 
delete access to the user who submitted the 
job with the DISPOSE request. The default 
is /NODELETE. 



/FEED 
/NOFEED 



Controls whether the PRINT command 
automatically inserts form feeds when it 
prints files that do not have carriage 
control characters. By default, the $PRINT 
command inserts a form feed when the forms 
are within four lines of the end of the 
form. The default is /NOFEED. 



/FLAG_PAGE 
/NOFLAG PAGE 



Specifies if a flag page is printed 
preceding output. The default is 
/NOFLAG PAGE. 



/HEADER 
/NOHEADER 



Specifies if the file name is printed 
at the top of each output page. By default, 
the file specification is printed only at 
the top of the first page of output. 



/PAGE COUNT =n 



Indicates the number of file pages to print 



/SPACE 
/NOSPACE 



Controls whether output is double-spaced. 
If /SPACE in not specified, output is 
single-spaced. 
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5.6 $USER=nn DISPOSE STAGING COMMAND 

The format of the $USER=nn staging command is site specific. Consult 
your VAX/VMS station manager for details of the available $USER=rm 
staging commands. 
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ACQUIRE AND FETCH FACILITIES 



The COS ACQUIRE and FETCH control statements stage datasets from VMS 
files to Cray mainframe mass storage. ACQUIRE makes the dataset a 
permanent COS dataset. With a FETCH statement, the dataset remains local 
to the job requesting the VMS dataset. Section 4 describes the general 
formats of the ACQUIRE statement and the FETCH statement. Specific 
ACQUIRE and FETCH parameters used by the VAX/VMS station are as follows: 



Parameter VAX/VMS Station Usage 

dn See pdn 

pdn If the VMS file name is not specified in the TEXT field of 

an ACQUIRE statement, this parameter is the default VMS 
file name, dn is the default. 

sdn If the VMS file name is not specified in the TEXT field of 

a FETCH statement, this parameter is the default VMS file 
name, dn is the default. 

mf Mainframe identifier of VAX/VMS station 

tid Used internally by the VAX/VMS station. This parameter 

should not be specified by the user. 

df One of the following dataset formats: 

CB VAX/VMS station blocks the VMS file into COS blocked 
format and compresses blanks. 

BB VAX/VMS station blocks the VMS file with COS blocked 
format. 

TR VAX/VMS station sends the VMS file to COS as a bit 
string. 

text Used by the VAX/VMS station to determine the VMS device 

type and file for the ACQUIRE and FETCH statements (see 
subsection 6.1) 
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6.1 ACQUIRE/FETCH TEXT FIELD CONTENTS 

The ACQUIRE or FETCH TEXT field contains an ASCII string of up to 240 
characters. When specified, the staging command and file descriptor must 
be separated by one or more spaces. 



Format: 



(<staging command>(/<command qualifiers>)) 
(<file descriptor>(/<file qualifiers>)) 



staging command 

Optional element identifying the VMS source device for 
datasets staged to COS. The valid commands are $DISK, 
$TAPE, and $USERnn. Table 6-1 summarizes all available 
staging commands. $DISK is the default. 

/command qualifiers 

Optional element consisting of one or more qualifiers each 
having the general form /QUAL [=< value> ] . The command 
qualifier is specified only if the staging command is 
specified. Individual staging command sections describe 
the qualifiers. 

file descriptor 

Optional element consisting of a formatted ASCII string 
uniquely identifying the VMS source file on the specified 
device type 

file qualifiers 

Optional element consisting of or more qualifiers each 
with the general form /QUAL= < value > 



Table 6-1. ACQUIRE/FETCH Staging Commands 



Command 


Description 


Subsection 


$DISK 
$TAPE 
$USER=nn 


Stages from VMS disks 
Stages from VMS tapes 
Installation specific 


6.2 
6.3 
6.4 
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6.2 $DISK ACQUIRE/FETCH STAGING COMMAND 

The $DISK ACQUIRE or FETCH staging command stages disk resident VMS files 
to COS datasets. If no command qualifiers are required, $DISK need not 
be specified. 



Format: 



I I 

| ($DlSK(/< command qualifier*)) (<file descriptor* (/<f He qualifier*)) \ 

I I 



6.2.1 $DISK COMMAND QUALIFIER 

$DISK command qualifiers qualify the $DISK staging command. The 
following command qualifier is recognized: 

Qualifier Description 

/EOF=<eof> <eof> specifies a 1- to 80-character ASCII 

string at the beginning of a VMS record that 
causes a COS end-of-file separator in the 
COS dataset. If this qualifier is not 
specified, the station uses the default EOF 
separator. This qualifier is ignored for 
transparent datasets. 



6.2.2 $DISK FILE DESCRIPTOR 

The file descriptor element format is: 

( < node" user name password"* : : ) ( <dev> : ) ( [<directory> ] ) 
(<filename>)( . <type>) (;<version>) 



node"username password" : : 

Specifies standard DECnet node name for the target VAX 
node, together with a valid username and password pair; 
required only for requests from jobs that did not originate 
from the target VAX. username and password must be 
enclosed in double qoutes and separated by one space. 
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dev 



Standard VMS device name of a disk device supported by the 
VAX running the VAX/VMS station 



directory Standard VMS directory 

filename Standard VMS file name 

type Standard VMS file type 

version Standard VMS file version number 

See the VAX/VMS DCL Dictionary, DEC publication AA-Z200A-TE, for a full 
description of this format. Logical names can be used in place of the 
initial components of the file descriptor or in place of the whole file 
descriptor. The VAX/VMS DCL Dictionary describes logical names in 
general, as does section 4 of this manual. 

Defaults are supplied for missing components as follows: 

Parameter Default 



node"username password' 



dev: [<directory> ] 



filename 



type 



version 



Standard DECnet node name, username, and 
password for the target VAX node is required 
only if the request is from a job that was 
not submitted from the target VAX. 

If these components are missing, the station 
uses the equivalence of the logical name 
SYS$DISK. SYS$DISK is defined in the 
Process Local Logical Name Table for the 
log-on process of the user submitting the 
Cray job issuing the ACQUIRE or FETCH 
transfer. 

The default filename is the ACQUIRE pdn 
or FETCH sdn truncated to 9 characters, if 
necessary. 



CST 



Default is the highest existing version 
number for the file. 
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6.2.3 $DISK FILE QUALIFIERS 

The $DISK file qualifiers are as follows: 



Qualifiers 
/DELETE 



/RMS= I BLK 
REC 



Description 

Delete the VMS file after it is successfully 
staged 

Specifies the mode of operation for writing 
records to VMS files. The default is 
installation dependent and is set by the 
VAX/VMS station manager. 

BLK The station reads and deblocks the 
records. 

REC Records are written using RMS. RMS 
record transfers across DECnet are 
restricted to 16,384 bytes. 



For example, a FETCH from VMS disk may be specified as follows: 

FETCH, DN=CRYFILE,DF=BB,TEXT='$DISK/E0F= M **** M 
DBA1: [MYDIR]VAXFILE.DAT; 2/DELETE' . 

DN=CRYFILE Specifies that the COS local dataset name is CRYFILE 

DF=BB Specifies that the COS dataset format is binary blocked 

TEXT= ' $DISK/EOF= M **** M 

Specifies that the VMS file to be staged is disk 
resident and that the end-of-file separator is ****. 



DBA1: 



[MYDIR] 



Specifies that the VMS file to be staged is on VMS 
device DBA1. 

Specifies that the VMS file entry to be staged is in 
the directory MYDIR on device DBA1. 



VAXFILE.DAT; 2 Specifies that the VMS file to be staged is 

VAXFILE.DAT in directory MYDIR on device DBA1. The 
version number is 2. 

/DELETE Specifies that the VMS file DBA1: [MYF I LEjVAXFILE.DAT; 2 
is deleted after it is staged to the Cray mainframe. 
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6.3 $TAPE ACQUIRE/FETCH STAGING COMMAND 

The $TAPE ACQUIRE or FETCH staging command stages magnetic tape resident 
VMS files to COS datasets. $TAPE is a mandatory parameter for tape 
staging to COS. 



Format: 



I I 

| $TAPE/< command qualifiery (<.file descriptor>(/<file qualifier))) | 

I : I 



6.3.1 $TAPE COMMAND QUALIFIERS 

The following command qualifiers are recognized when the ACQUIRE or FETCH 
source device is magnetic tape. /VOLUME is the only required command 
qualifier. 



Qualifiers 
/V0LUME=( <vo!nam> , . 



/BLOCKSIZE=<n> 



/EOF= <eof> 



/FOREIGN 
/UNLOAD 



Description 

Volume name or names for a multivolume tape 
set; required qualifier. Maximum 6 
characters. The station requests each 
volnam in the VOLUME list to be loaded 
until it finds the specified file name. It 
then reads subsequent volumes until the 
total file is staged. 

Maximum block size for interchange format 
tapes; optional qualifier. 

<eof> specifies a 1- to 80-character ASCII 
string at the beginning of a VMS record that 
causes a COS EOF separator in the COS 
dataset; optional qualifier. If you do not 
specify this qualifier, the station uses the 
default EOF separator. This qualifier is 
ignored for transparent datasets. 

Required for interchange format tapes 

The volume is physically unloaded from the 
tape unit when staging is complete; optional 
qualifier. 
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6.3.2 $TAPE FILE DESCRIPTOR 

The file descriptor element format is: 

I I 

| (<dev>: ) ( <filename>) ( . <type>) \ 

I I 

dev Standard VMS device name of one of the magnetic tape 

devices supported by the VAX running the VAX/VMS station, 
If the controller or unit number is not specified, an 
available unit on that device will be selected 
automatically. 

filename Standard VMS file name 

type Standard VMS file type 

Both filename and type can be replaced by a 1 through 17 ASCII 
character ANSI file name delimited by quotes, as "ANSI TAPE FILE." 

Defaults are supplied for missing components as follows: 

Parameter Default 

dev The default tape device is determined by the VAX/VMS 

station manager. 

filename The default for the file name is the ACQUIRE pdn or 

FETCH sdn parameter. 

type CMT 



6.3.3 $TAPE FILE QUALIFIERS 

The file qualifiers used when using ACQUIRE or FETCH from a tape file are 
as follows: 

Qualifiers Description 

/ORG=BLK Required if the tape is read in interchange 

format 
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Qualifiers Description 

/RMS= J BLK | Specifies the mode of operation for writing 

l REC l records to VMS files. The default is 

installation dependent and is set by the 
VAX/VMS station manager. 

BLK The station reads and deblocks the 
records. 

REC Records are written using RMS. RMS 
record transfers across DECnet are 
restricted to 16,384 bytes. 



6.4 $USER=nn ACQUIRE/FETCH STAGING COMMAND 

The $USER=nn ACQUIRE OR FETCH staging command format is site specific. 
Consult your VAX/VMS station manager for details of the available 
$USER=nn staging commands. 
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USING THE COS 
INTERACTIVE FACILITIES 



This section describes the COS interactive facilities provided by the 
VAX/VMS station. The interactive facilities allow you to log on directly 
to the Cray Computer System to start a COS job. Section 3 describes the 
COS batch processing facilities. 

This section is divided into the following areas: 

• Overview 

• Starting and ending a COS interactive session 

• Using the terminal handling facilities 

• Advanced Video Facilities available on VTlOO-compatible terminals 

• Setting screen width 

• Line editing 

To aid your understanding of the COS interactive facilities, a FORTRAN 
interactive example is provided at the end of the section. 



7.1 OVERVIEW 

The interactive facility of the VAX/VMS station allows you to log on 
interactively to the Cray Computer System to start a COS job. In the 
interactive environment, you enter COS job control statements one at a 
time after the interactive prompt ( ! ) . You can observe the results of 
each COS job control statement before you proceed to the next. During 
program or utility execution, references to the COS datasets $IN and $OUT 
cause I/O at your terminal. 

Table 7-1 shows the interactive commands available to VAX/VMS station 
users. The SET TERMINAL station command, described in the Command 
Reference section, is also used to set terminal characteristics for 
interactive mode. 
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Table 7-1. Interactive Station Commands 



Command 



Function 



ABORT 

ATTACH 
ATTENTION 



BYE 

COLLECT 
DISCARD 

EOF 

INTERACTIVE 

I STATUS 
QUIT 



Interrupts the current interactive COS job step and 
returns to the Control Statement Processor (CSP) for 
further COS JCL statements. 

Redirects Cray interactive terminal output 

Interrupts current interactive COS job step and enters 
reprieve processing, if any. If no reprieve 
processing is specified/ the command has the same 
effect as ABORT. 

Terminates an interactive session. Command qualifiers 
allow the COS job to continue running or to be 
terminated. 

Stores COS interactive output in a VMS file 

Discards interactive output from COS up to the next 
prompt for input from COS 

Sends an end-of-file record to the current COS 
interactive job 

Initiates or restarts an interactive session. Command 
qualifiers allow the COS job name and user name to be 
specified. 

Returns the status of the current interactive job, CPU 
time used, and the last logfile message 

Terminates the interactive session and the 
corresponding COS job. Same as BYE/ABORT. 
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7.2 STARTING A COS INTERACTIVE SESSION 

Starting a COS interactive session is a two-part process. 

1. Enter the VAX/VMS station command CRAY at any terminal logged on 
to VMS. Issuing this command enters the station into Cray 
context. For example: 

$ CRAY < RET > 

CRAY> 

2. Enter the VAX/VMS station command INTERACTIVE, using the /JN= and 
/US= parameters to specify jobname and username. For example: 

CRAY> INTERACTIVE/JN=TEST/US=USER<RET> 

If the INTERACTIVE station command is executed successfully, your 

VMS terminal is logically connected to the COS interactive job 

that has been created. If you do not supply a job name and user 
name, the system prompts you for these values. 

When you enter interactive mode, the usual region divider is replaced by 
a Cray interactive banner. 

You can reenter Cray context command mode by using CTRL/Z after the 
interactive prompt (!). Most commands execute, then reconnect the 
terminal to the COS interactive job. 



7.3 EXITING COS INTERACTIVE 

You can disconnect your VMS terminal from the COS job permanently by the 
following process: 

1. Enter CTRL/Z after the interactive prompt to reenter Cray context 
command mode. 

2. Enter the BYE or QUIT station commands after the CRAY> prompt. 

The QUIT station command terminates both the session and the interactive 
job. The BYE station command, without qualifiers, terminates the 
session, but does not terminate the associated interactive job. For 
example, the following commands terminate both the interactive session 
and the COS interactive job: 

! ~Z 

CRAY> QUIT < RET > 



SV-0020 7-3 



7.4 INTERACTIVE EXAMPLE TERMINAL SESSION 

The following example illustrates some of the terminal handling 
facilities that can be used during an interactive session. A detailed 
explanation follows the example; the line numbers correspond to the 
explanation. 

1) $ CRAY/NOREFRESH<RET> 

2) CRAY> INTERACTIVE < RET > 

3) Cray Jobname: CRAYJOB<RET> 

4) Cray Username: CRAYUSER<RET> 

5) CRAY-1 site header 09/02/85 

CRAY-1 OPERATING SYSTEM COS 1.14 ASSEMBLY DATE 06/25/85 

6) ! ACCOUNT, AC=MYACC.< RET > 

7) ! ACCESS ,DN=MYFILE,ID=MYID.< RET > 

8) PD000 - ACCESS MYFILE ED=000 2 COMPLETE 

9) ! "Z 

10) CRAY> SET TERMINAL PAGE=10<RET> 

11) j ACCESS ,DN=MYFILE1,ID=MYID.< RET > 

12) PD000 - ACCESS MYFILE1 ED=0002 COMPLETE 

13) ! "Z 

14) CRAY> $ SHOW TIME < RET > 

15) 02-SEP-1985 12:00:00.00 

16) $ LOGOUT<RET> 

17) ! ~Z 

18) CRAY> QUIT<RET> 

19) BYE 

20) CRAY> EXIT<RET> 

21) $ 

1) $ CRAY/NOREFRESH<RET> 

The VAX/VMS station command CRAY activates Cray context with no 
screen formatting. 

2) CRAY> INTERACTIVE < RET > 

CRAY> is the prompt from the station; INTERACTIVE requests the 
station to start a COS interactive session. 

3) Cray Jobname: CRAYJOB<RET> 

Interactive prompt for the COS job name. The job name identifies the 
job on the Cray Computer System and must be used for any subsequent 
logons to the same COS interactive job. 

4) Cray Username: CRAYUSER<RET> 

Interactive prompt for the COS user name. The job name and the user 
name uniquely identify the COS interactive job. 

5) CRAY-1 site header 09/02/85 

CRAY-1 OPERATING SYSTEM COS 1.14 ASSEMBLY DATE 06/25/85 
COS introductory message for this installation 
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6) ! ACCOUNT, AC=MYACC.< RET > 

The ! is the COS prompt for JCL input. If this is a new COS 
interactive session, the COS ACCOUNT JCL statement must be the first 
response to the ! prompt. 

7) ! ACCESS, DN=MYFILE,ID=MYID.< RET > 

JCL statement to access the COS dataset MYFILE 

8) PD000 - ACCESS MYFILE ED=0002 COMPLETE 
COS response to the ACCESS statement 

9) ! Z 

CTRL/Z is input to reenter station command input mode. 

10) CRAY> SET TERMINAL PAGE=10<RET> 

Station interactive command to set the number of COS interactive 
output lines displayed before the station stops and allows you to 
intervene. 

11) ! ACCESS, DN=MYFILE1,ID=MYID.< RET > 

COS JCL statement to access the COS dataset MYFILE1 

12) PD000 - ACCESS MYFILE1 ED=0002 COMPLETE 
COS response to the ACCESS statement 

13) ! "Z 

Z is input to reenter station command input mode. 

14) CRAY> $ SHOW TIME < RET > 

A $ prefix allows the DCL command SHOW TIME to be issued. 

15) 02-SEP-1985 12:00:00.00 

Response to the DCL command SHOW TIME 

16) $ LOGOUT<RET> 

LOGOUT is input to terminate the DCL subprocess and return to Cray 
context. 

17) ! "Z 

Z is input to reenter station command input mode. 

18) CRAY> QUIT<RET> 

Interactive command disconnecting the VMS terminal from the COS 
interactive job. The QUIT command terminates the COS interactive job 
at the completion of the current job step. 

19) BYE 

The COS acknowledgment of the QUIT command 
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20) CRAY> EXIT<RET> 

Station command returning you to DCL level 

21) $ 

DCL prompt 



7.5 ADVANCED VIDEO FACILITIES 

When the COS interactive facility is activated at a terminal with the 
DEC_CRT terminal characteristic set, the station splits the screen into 
COS interactive region at the top and a scrolled command region at the 
bottom. The two regions are separated by an interactive banner that 
replaces the usual region divider. Figure 7-1 shows the screen format. 



CRAY-l site header 

CRAY-l OPERATING SYSTEM 
! ACCOUNT, AC =MYACC. 
! ACCESS, DN=MYFILE,ID=MYID. 
PD000 - ACCESS MYFILE 
! ~Z 

! ACCESS, DN=MYFILE1,ID=MYID. 
PD000 - ACCESS MYFILE1 
! "Z 
BYE 



COS 1.12 



09/02/85 
06/25/85 



ED=0005 COMPLETE 



ED=0002 COMPLETE 



dd-mm-yyyy nn:mm:ss:cc 



Node name 



INTERACTIVE 



CRAY> INTERACTIVE 
Cray JOBNAME: CRAYJOB 
Cray USERNAME: CRAYUSER 
CRAY> SET TERMINAL PAGE =10 
CRAY> QUIT 



Figure 7-1. COS Interactive Facility Split Screen 



7.5.1 ALTERING THE COMMAND SCROLL AREA 

You can alter the proportion of the screen devoted to command input by 
using the SCROLL parameter of the SET TERMINAL command. Use the 
following format: 
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CRAY> SET TERMINAL SCR0LL=7.ines<RET> 

lines is the size of the command scroll region, which can be a decimal 
integer from 3 through 13. The following command sets the command scroll 
area size to 5: 

CRAY> SET TERMINAL SCROLL=5<RET> 

If the PAGE option is active, this command also sets the page size to 
18. If the COS interactive area is reduced in size, any existing output 
is scrolled up the screen by the number of lines reduced. 



7.5.2 SETTING SCREEN WIDTH 

When you are in COS interactive mode, you can set the screen width to 80 
or 132 columns by using the WIDTH parameter of the SET TERMINAL station 
command. For example: 

CRAY> SET TERMINAL WIDTH=132 <RET> 

This command allows you to view interactive output that would normally 
exceed 80-character screen widths. 



NOTE 

Setting the screen width initializes the screen. Any 
previous output is lost. 



7.5.3 SETTING PAGE SIZE OF COS OUTPUT 

When you are in COS interactive mode, you can regulate the number of lines 
you receive from the Cray Computer System without interruption with the 
PAGE=Iines command qualifier of the SET TERMINAL station command. For 
example: 

CRAY> SET TERMINAL PAGE=52<RET> 

This example specifies 52 as the number of lines in a page of Cray 
interactive output. To receive the next page of interactive output, press 
the carriage return. 

You can specify whether COS interactive output is continuous with the PAGE 
and NOPAGE command parameters of the SET TERMINAL command. 
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7.6 FORTRAN INTERACTIVE EXAMPLE 

The VAX/VMS station interactive interface provides for direct input and 
output to a previously written FORTRAN program. The following example 
illustrates the saving, compilation, and execution of a FORTRAN program 
through the station. A detailed explanation follows the example; the 
line numbers correspond to the explanation. 

1) $ CRAY<RET> 

2) CRAY> INTER/ JN=CRAY JOB/US =CRAYUSER< RET > 

3) CRAY-l site header 09/02/85 

CRAY-l OPERATING SYSTEM COS 1.14 ASSEMBLY DATE 06/25/85 

**** SITE SPECIFIC MESSAGES **** 



4) ! ACCOUNT, AC=user -account -number. <RET> 

5) ! ACQUIRE, DN=SOURCE,PDN=EXAMPLE,ID=FOR,TEXT="EXAMPLE. FOR". <RET> 

6) PD000 - PDN = EXAMPLE ID = FOR ED = 1 OWN = owner 
PD009 - DATASET NOT FOUND 

VAX TO CRAY: %SYSTEM-S -NORMAL, normal successful completion 
VAX TO CRAY: FILE = UMAO : [HENRY ] EXAMPLE. FOR; 1 
VAX TO CRAY: 328 BYTES TRANSFERRED 

SS004 - DATASET RECEIVED FROM FRONT END 

PD000 - PDN = EXAMPLE ID = FOR ED = 1 OWN = owner 

PD000 - SAVE COMPLETE 

7) ! CFT,I=SOURCE,L=0. <RET> 

CFT000 - CFT VERSION - 07/30/83 1.11 
CFT001 - COMPILE TIME = 0.0144 SECONDS 
CFT002 - 31 LINES, 23 STATEMENTS 
CFT003 - 37019 WORDS, 8396 I/O BUFFERS USED 

8) ! LDR,NX,AB=OUTPUT.<RET> 

9) ! SAVE, DN=OUTPUT,PDN=EXAMPLE,ID=EXE.< RET > 
PD000 - PDN = EXAMPLE ID = EXE ED = 1 
PD000 - SAVE COMPLETE 

10) ! OUTPUT. < RET > 

11) PROGRAM CSTSEN1 - Test SENSE switches 

SENSE SWITCH SETTINGS FOLLOW: 

Return is 1 if switch is ON - 2 if OFF 

Switch number 1 value = 2. 

Switch number 2 value = 2. 

Switch number 3 value = 2. 

Switch number 4 value = 2. 

Switch number 5 value = 2. 

Switch number 6 value = 2. 

Enter to stop - 1 to repeat display 
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12) ? 0<RET> 

13) UT010 - STOP IN CSTSEN1 

14) ! ~Z 

15) CRAY> QUIT<RET> 

16) BYE 

17) CRAY> EXIT<RET> 

18) $ 



1) $ CRAY<RET> 

The VAX/VMS station command CRAY activates Cray context. 

2 ) CRAY > INTER/ JN=CRAY JOB/US =CRAYUSER < RET > 

Cray interactive is initiated. 

3) CRAY-1 site header 09/02/85 

CRAY-1 OPERATING SYSTEM COS 1.14 ASSEMBLY DATE 06/25/85 
COS introductory message for this installation 

4) ! ACCOUNT, AC=user-account-number. <RET> 

The ! is the COS prompt for JCL input. If this is a new COS 
interactive session, the COS ACCOUNT JCL statement must be the first 
response to the ! prompt. 

5) ! ACQUIRE, DN=SOURCE,PDN=EXAMPLE, ID=FOR,TEXT=" EXAMPLE. FOR". <RET> 
ACQUIRE control statement specifying that the source FORTRAN file 
existing on the VAX front-end should be staged to COS mass storage 
and made local to the job. 

6) PD000 - PDN = EXAMPLE ID = FOR ED = 1 OWN = owner 
PD009 - DATASET NOT FOUND 

VAX TO CRAY: %SYSTEM-S -NORMAL, normal successful completion 

VAX TO CRAY: FILE = UMAO : [HENRY ] EXAMPLE. FOR; 1 

VAX TO CRAY: 328 BYTES TRANSFERRED 
SS004 - DATASET RECEIVED FROM FRONT END 

PD000 - PDN = EXAMPLE ID = FOR ED = 1 OWN = owner 
PD000 - SAVE COMPLETE 

Messages indicating that COS did not find the specified dataset on 
mass storage and then successfuly staged the file EXAMPLE . FOR ; 1 from 
the VAX front-end. This file contains the source FORTRAN code. 

7) ! CFT,I=SOURCE,L=0.<RET> 

CFT000 - CFT VERSION - 07/30/83 1.11 

CFT001 - COMPILE TIME = 0.0144 SECONDS 

CFT002 - 31 LINES, 2 3 STATEMENTS 

CFT003 - 37019 WORDS, 8396 I/O BUFFERS USED 

This statement invokes CFT to compile dataset accessed as DN=SOURCE. 

L=0 specifies to output only fatal error messages. 
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8) ! LDR,NX,AB=OUTPUT.<RET> 

This statement loads absolute binary object module to a DN=OUTPUT. 
NX means that the load module is not executed at this step. 

9) ! SAVE, DN=OUTPUT,PDN=EXAMPLE,ID=EXE.< RET > 

PD000 - PDN = EXAMPLE ID = EXE ED = 1 

PDOOO - SAVE COMPLETE 

This statement saves relocatable load module to a permanent dataset 

for later execution. 

10) ! OUTPUT. < RET > 

Execute program 

11) PROGRAM CSTSEN1 - Test SENSE switches 

SENSE SWITCH SETTINGS FOLLOW: 

Return is 1 if switch is ON - 2 if OFF 

Switch number 1 value = 2 . 
Switch number 2 value = 2 . 
Switch number 3 value = 2. 
Switch number 4 value = 2. 
Switch number 5 value = 2 . 
Switch number 6 value = 2 . 

Enter to stop - 1 to repeat display 

User program outputs information to $OUT/CRT and requests input. 

12) ? 0<RET> 

You enter from your terminal, which the program receives as $IN. 

13) UT010 - STOP IN CSTSEN1 
FORTRAN program terminates normally. 

14) ! ~Z 

A CTRL/Z sequence returns you to station command mode to terminate 
the COS job. 

15) CRAY> QUIT<RET> 

CRAY> is the prompt from the station; QUIT requests the station to 
log you off COS interactive and terminate the COS job. 

16) BYE 

The COS acknowledgment of the QUIT command 

17) CRAY> EXIT<RET> 

You now exit Cray context and return to DCL. 

18) $ 

DCL prompt. 
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The following is a source listing for the FORTRAN program acquired from 
the VMS file UMAO: [FORTRAN. SOURCE] EXAMPLE. FOR. 

PROGRAM CSTSEN1 
C 

INTEGER SW 
INTEGER RESULT 
INTEGER USERSW 
C 

WRITE (6,*) 'PROGRAM CSTSEN1 - Test SENSE switches' 
WRITE(6,*) ' ' 
C 
100 WRITER,*) 'SENSE SWITCH SETTINGS FOLLOW:' 

WRITE(6,*) 'Return is 1 if switch is ON - 2 if OFF' 
WRITE(6,*) ' ' 
C 
110 DO 150,SW=1,6,1 

CALL SSWITCH(SW, RESULT) 
WRITE ( 6 , 1000 ) SW, RESULT 
150 CONTINUE 
C 

WRITER,*) ' ' 

WRITER,*) 'Enter to stop - 1 to repeat display* 
READ(5,*) USERSW 
IF ( USERSW. NE.0) GOTO 100 
C 

1000 FORMAT ( ' Switch number Ml,' value = ',11,'.') 
C 
9000 CONTINUE 
STOP 
END 
C 
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COMMAND REFERENCE 



This section describes all VAX/VMS station commands that are available to 
users . 

Each command description starts on a new page and provides the following 
information: 

• Command name 

• Brief description 

• Command format 

• Command qualifiers 

• Availability 

• Prompts 

• Command parameters 

• Description 

See section 2 for information on the syntax and use of station commands. 



AVAILABILITY CODES 

The availability codes used in this section describe: 

• When the station commands can be used (When), 

• Whether the station commands can be entered at DCL level (DCL), 
and 

• At which type of VAX/VMS station the station commands can be used 
(station) . 

Table command-1 and the individual command descriptions later in this 
section use the following availability codes to describe the station 
commands . 
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The When codes are: 

Code Description 

ANY The command can be issued at any time, as long as the 
VAX/VMS station is installed. 

INT The command can be issued if an interactive session has been 
initiated. 

LON The command can be issued if the station is communicating 
with COS (logged on). 

The DCL codes are: 

Code Description 

NO The command is only available inside Cray context. 

YES The command can be executed at DCL level. 

ONLY The command is available only at DCL level. 
The Station codes are: 

Code Description 

ANY The command is available at both attached and remote VAX/VMS 
stations. 

ATT The command is available at the attached VAX/VMS station 
only. 

REM The command is available at the remote VAX/VMS station only. 



ABBREVIATIONS 

Commands can be abbreviated to any length. If an abbreviated command 
string is ambiguous, the first eligible station command is executed. 
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Table Command-1. User Station Commands 







Availability 


Station 




Code 


Command 


Description 


When/DCL/Station 


+ 


Gets the next page of a 
refresh display 


ANY/NO/ANY 


- 


Gets the previous page of a 
refresh display 


ANY/NO/ANY 


Qfile-spec 


Executes an indirect station 
command file from this VMS 
file specification 


ANY/NO/ANY 


$ 


Allows entry of DCL commands 
from within Cray context 
command mode 


ANY/NO/ANY 


CTRL/Z 


Returns the user to previous 
state 


ANY/NO/ANY 


ABORT 


Interrupts the current 
interactive COS job step 
and returns to the Control 
Statement Processor (CSP) 


INT/NO/ ATT 


ATTACH 


Redirects COS interactive 
terminal output 


INT/NO/ATT 


ATTENTION 


Interrupts the current 

interactive COS job step 

and enters reprieve processing 


INT/NO/ATT 


BYE 


Terminates a COS interactive 
session 


INT/NO/ATT 


CHOOSE 


Selects a Cray Computer System 
to be accessed 


ANY/ONLY/ANY 


CLEAR 


Clears the screen display area 


ANY/NO/ANY 


COLLECT 


Stores COS interactive output 
in a VMS file 


INT/NO/ATT 


COMMENT 


Inserts comments into a 
command stream 


ANY/NO/ANY 



SV-0020 



Command- 3 



Table Command- 1. User Station Commands (continued) 







Availability 


Station 




Code 


Command 


Description 


When/DCL/Station 


CRAY 


Enters the user into Cray 
context or executes a single 
station command 


ANY/ONLY/ANY 


DATASET 


Reports the existence of a 
COS permanent dataset 


LON/YES/ANY 


DELAY 


Suspends execution of an 
indirect station command 
file for a specified time 


ANY/NO/ANY 


DISCARD 


Discards interactive output 
from COS 


INT/NO/ATT 


DROP 


Drops a COS job 


LON/YES/ANY 


EOF 


Sends an end-of-file record 
to the current COS 
interactive job 


INT/NO/ATT 


EXIT 


Returns the user from Cray 
context command mode to 
DCL command state 


ANY/NO/ANY 


HELP 


Displays information from 
the station help files 


ANY/YES/ANY 


INTERACTIVE 


Initiates an interactive 
session 


LON/YES/ATT 


I STATUS 


Displays the status of the 
user's interactive job 


INT/NO/ATT 


JOB 


Displays the status of a 
specific COS job 


LON/YES/ANY 


JSTAT 


Displays the status of a 
specific job and its related 
tasks 


LON/YES/ANY 


KILL 


Kills a COS job 


LON/YES/ANY 
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Table Command-1. User Station Commands (continued) 







Availability 


Station 




Code 


Command 


Description 


When/DCL/Station 


LOGFILE 


Provides access to the station 
logfile messages 


ANY/YES/ANY 


LOOP 


Restarts execution of an 
indirect station command file 


ANY/NO/ANY 


MESSAGE 


Enters a message into the COS 
job logfile, the COS system 
logfile, or both 


ANY/NO/ANY 


PAUSE 


Suspends execution of an 
indirect station command file 
and switches control to the 
terminal 


ANY/NO/ANY 


PLAY 


Executes an indirect station 
command file 


ANY/YES/ANY 


QUIT 


Terminates an interactive 
session and the corresponding 
COS job 


INT/NO/ATT 


RECORD 


Starts or stops the recording 
of terminal input for later 
use with the PLAY command 


ANY/NO/ANY 


RELEASE 


Releases a dataset held on 
the COS job gueue 


LON/YES/ANY 


REMOVE 


Deletes entries in the VAX/VMS 
station staging queue 


ANY/YES/ANY 


RERUN 


Reruns a COS job 


LON/YES/ANY 


SAVE 


Stages a single file to COS 
mass storage 


ANY/YES/ANY 


SET TERMINAL 


Sets the terminal working 
environment 


ANY/NO/ANY 
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Table Command- 1. User Station Commands (continued) 







Availability 


Station 




Code 


Command 


Description 


When/DCL/Station 


SHOW QUEUES 


Displays entries in the VAX/VMS 
station dataset staging queue 


ANY/YES/ANY 


SNAP 


Copies the display screen image 
to a VAX/VMS file 


ANY/NO/ANY 


STATUS 


Displays COS status 


LON/YES/ANY 


SUBMIT 


Stages a job to COS 


ANY/YES/ANY 


SWITCH 


Manipulates the COS job sense 
switches 


LON/YES/ANY 


TAPE 


Displays COS tape device 
information 


LON/YES/ANY 


TJOB 


Displays the status of COS 
tape jobs 


LON/YES/ANY 
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Gets the next page of a refresh display 
Format 



Command Qualifiers Default 

None None 

Availability 

When=ANY DCL=NO Station=ANY 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

This command advances the page currently displayed, that is, the next 
consecutive page of the display is requested. If the existing display 
indicates the end of data, the command has no effect. This command is 
available only from within refresh-style Cray context command mode. 
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Gets the previous page of a refresh display 
Format 



Command Qualifiers Default 

None None 

Availability 

When=ANY DCL=NO Station=ANY 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

This command reverses the effect of the + command and displays the 
previous page of the current display. If the existing display indicates 
page one, the command has no effect. This command is available only 
within refresh-style Cray context command mode. 
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Executes an indirect station command file 
Format 



^file-spec 


Alternate Form 




PLAY file- spec 


Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 

PLAY filename: 



Appropriate Input 
file-spec 



Command Parameter 



file-spec 



A standard VAX/VMS file specification 



Description 

This format is a synonym for the PLAY command. It initiates the 
execution of an indirect station command file. The indirect station 
command file provides a facility that parallels a VMS command procedure, 
that is, it provides a mechanism for a series of commands to be issued. 
Requested refresh displays can be observed for a period of time by 
including PAUSE and DELAY commands in the indirect command file. 

The command currently being processed from the indirect command file is 
echoed at the terminal. 
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$ 

Allows entry of DCL commands from within Cray context command mode 
Format 



$[ command] 




Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts Appropriate Input 

None None 

Command Parameter 

[command] Any valid VMS command 



Description 

This command allows temporary entry of DCL commands from within Cray 
context command mode. The system carries out this facility by creating a 
VMS subprocess that temporarily controls the terminal. This implies that 
a small number of DCL commands may not work as expected, for example, the 
definition of process logical names. (VMS subprocesses are explained in 
the VAX/VMS DCL Dictionary, DEC publication AA-Z200A-TE. See the SPAWN 
command. ) 

To return to Cray context, enter LOGOUT. 
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CTRL/Z 

Returns the user to previous state 

Format 



CTRL/Z 

Command Qualifiers 
None 

Availability 
When=ANY DCL=NO 



Default 



None 



Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 

This command can be used in the following circumstances: 

• During command parameter prompting; the result is to cancel the 
previously entered command. 

• In response to the Cray context prompt CRAY>; the result is 
identical to entering the EXIT command, which returns the user to 
DCL command state. 

• During a Cray interactive session at an attached VAX/VMS station; 
the result is to return the user to command mode. 

• During execution of an indirect station command file; the result 
is to terminate execution. 
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ABORT 

Interrupts the current interactive COS job step and returns to the 
Control Statement Processor (CSP) 

Format 



Command Qualifiers Default 

None None 

Availability 

When=INT DCL=NO Station=ATT 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

ABORT interrupts the current COS job step and returns to CSP, which then 
issues the ! prompt. Any COS output queued for the terminal is displayed 
before the ! prompt is issued. 
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ATTACH 

Redirects COS interactive terminal output 

Format 



ATTACH [alt-device] 






Command Qualifiers 




Default 


/CHAR=( char ,pos) 






/MRS=max rec size 




/MRS=132 


/OFF 






/ON 




/ON 


Availability 






When=INT DCL=NO 


Stat 


ion=ATT 



Prompts 
None 



Appropriate Input 
None 



Command Parameter 



alt-device 



The device to receive the alternate 
routing. If not specified, the ATTACH 
command qualifiers are applied to the 
current output device. 



Description 

ATTACH defines an alternate device to receive Cray interactive output , 
The command is useful in redirecting graphics output to an alternate 
device. 
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Command Qualifiers 
/ CHAR =( char ,pos) 



If the character char occurs in character 
position in the Cray interactive record, the 
entire record is routed to the alternate 
device. 



/MRS=max rec size 



If any Cray interactive record exceeds the 
max_rec_size parameter, the record is 
routed to the alternate device » No carriage 
control character is used when records 
satisfy the MRS criteria. /MRS=132 is the 
default. 



/OFF 



/ON 



Switches alternate routing off. When /OFF 
is specified, all other parameters or 
qualifiers are ignored. 

Switches alternate routing on 
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ATTENTION 

Interrupts the current interactive COS job step and enters reprieve 
processing 

Format 



ATTENTION 




Command Qualifiers 


Default 


None 


None 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

ATTENTION interrupts the current COS job step and enters reprieve 
processing. If reprieve processing has not been specified for the COS 
job, ATTENTION processing is the same as ABORT. For further information 
on reprieve processing, see the COS Version 1 Reference Manual, 
publication SR-0011. 
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BYE 

Terminates a COS interactive session 

Format 



BYE 




Command Qualifiers 


Default 


/ABORT 




/SAVE 


/SAVE 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts 
None 



Appropriate Input 
None 



Description 

BYE terminates an interactive session. Depending on the command 
qualifiers, the COS interactive job may also be terminated. 



Command Qualifiers 
/ABORT 

/SAVE 



Terminates interactive session and COS 
interactive job. QUIT is an alternative way 
of specifying BYE/ABORT. 

Terminates interactive session. The 
associated interactive job remains active. 
If the job reaches a COS system threshold 
for output messages or requires input, the 
job is suspended. The interactive session 
can be reactivated by using the INTERACTIVE 
station command with the appropriate job and 
username. 
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CHOOSE 

Selects a Cray Computer System to be accessed 

Format 



(No Cray context form) 

DCL-level form 

$ CHOOSE (installation-defined) 

Command Qualifiers Default 

None 

Availability 

When=ANY DCL=ONLY Station=ANY 



Prompts Appropriate Input 

( Installation-defined) ( Installation-defined) 

Command Parameters 

( Installation-defined) 



Description 

CHOOSE is used by sites that have more than one Cray Computer System 
available to users. The CHOOSE command allows users to alternate between 
Cray Computer Systems. CHOOSE runs an installation-defined VAX/VMS 
command procedure that redefines the available commands. It is possible 
to operate in the context of only one Cray Computer System at a time. 
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Example 



$ CHOOSE CRAY1<RET> 

%CHOOSE-S -SELECTED, Process connected to the CRAY1 

$ CRAY SUBMIT MYJOBl<RET> 

%CX-S-SUB_OK, Job: JOB1 queued for submission 

$ CHOOSE CRAYXMP<RET> 

^CHOOSE -S -SELECTED, Process connected to the CRAY1 

$ CRAY SUBMIT MYJOBX<RET> 

•krV-R-RTTR ClK . .Tnh? .TORI rm«aii«»rl fnr anhmissinn 
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CLEAR 

Clears the screen display area 

Format 



CLEAR 

Command Qualifiers 
None 

Availability 
When=ANY DCL=NO 



Default 



None 



Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 



CLEAR is available only within refresh-style Cray context. It removes 
the current display and leaves the refresh display region clear. 
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COLLECT 

Stores COS interactive output in a VMS file 

Format 



COLLECT file-spec 




Command Qualifiers 


Default 


/[NO] ECHO 


/ECHO 


/OFF 




/ON 


/ON 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts 

COLLECT filename: 



Appropriate Input 
file-spec 



Command Parameter 



file-spec 



A standard VAX/VMS file specification 



Description 

COLLECT directs output generated by a COS interactive job to a VMS file, 
This command can be used before the interactive job is initiated. 



Command Qualifiers 

/ECHO 
/NOECHO 



Specifies whether the output generated by 
the COS job is sent to the terminal. In 
both /ECHO and /NOECHO, the output generated 
by the COS job is sent to the VMS file. 
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Command Qualifiers (continued) 

/OFF Reverses the effect of a previous COLLECT 

command. The file is closed. When /OFF is 
specified, all other qualifiers or 
parameters are ignored. 

/ON Maintains the effect of a previous COLLECT 

command 
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COMMENT 

Inserts comments into a command stream 

Format 



COMMENT string 




Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameter 



string 



Character string; limit is 256 characters, 
including the command COMMENT. 



Description 

COMMENT allows entry of comments into the output created when an indirect 
station command file is executed. COMMENT is effectively a null command; 
all text entered on the same line after COMMENT is echoed to the display 
screen, but is not executed by VMS. 



Examples 

(1) In this example, file PLAY. DAT contains the following: 

SUBMIT GETPDS.JOB 

COMMENT OUTPUT GENERATED BY JOB APPEARS NEXT 

JOB GETJOB 
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Examples (continued) 

The following output is sent to the terminal: 

CRAY> PLAY PLAY. DAT< RET > 

PLAY> SUBMIT GETPDS.JOB 

%CX-S-SUB_OK, Job: GETJOB queued for submission 

PLAY> COMMENT OUTPUT GENERATED BY JOB APPEARS NEXT 

PLAY> JOB GETJOB 

COS JOB GETJOB IS EXECUTING 

CRAY> 

(2) In this example, COMMENT is entered at the terminal: 

CRAY> COMMENT THIS IS A DEMONSTRATION RET > 

CRAY> 
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CRAY 

Provides entry into Cray context or executes a single station command 

Format 



(No Cray context form) 




DCL-level Form 




$ CRAY [station-command] 




Command Qualifiers 


Default 


/ [NO] BREAKTHROUGH 


/NOBREAKTHROUGH 


/[NO] REFRESH 


Determined by terminal type 


Availability 




When=ANY DCL=ONLY 


Station=ANY 



Prompts 
CRAY> 



Appropriate Input 
stat ion- command 



Command Parameter 



stat ion- command 



Any station command also available at DCL 
level. If this parameter is present, the 
user is returned to DCL at the completion of 
the command. Information broadcasting is 
not affected. To specify lowercase 
characters from DCL level, the entire 
station command should be enclosed in 
quotation marks ("). 



Description 

CRAY enters the user into Cray context or executes a single station 
command. If a command parameter is not included after the CRAY command, 
the user remains in Cray context until entry of the EXIT command. 
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Description (continued) 

Cray context provides a command selection mechanism, a gateway to COS 
interactive processing, and an optional refreshed display capability. 
Commands are available both at DCL level and from within Cray context; 
however, a subset of these commands related to refreshed display and 
interactive processing is available only within Cray context. If no 
command qualifier is used, the style of command input mode entered 
depends on the terminal type. If the terminal has the DEC_CRT 
capabilities, the split screen refresh style is selected, as shown in 
figure 6-3. Otherwise, nonrefresh style (scroll only) is selected. 



Command Qualifiers 



/BREAKTHROUGH 
/NOBREAKTHROUGH 



Controls whether a display refresh occurs 
during command input. /NOBREAKTHROUGH is 
suited to terminals that are run at slow 
speeds. Affects refresh-style Cray context 
only. If the user performs text editing in 
/BREAKTHROUGH mode, refresh displays place 
the cursor at the beginning of the command 
line. /NOBREAKTHROUGH is the default. 



/REFRESH 
/NOREFRESH 



Specifies whether refresh-style (split 
screen) or nonref resh-style (line-by-line) 
Cray context is desired. To use 
refresh-style (/REFRESH), the terminal must 
have the DEC_CRT option. /NOREFRESH is the 
default for terminals without the advanced 
display capabilities. /REFRESH is the 
default for terminals with the advanced 
display capabilities. 



Examples 

(1) $ CRAY<RET> 

CRAY> SUBMIT MYSUB . JOB < RET > 

%CX-S-SUB_OK, Job: MYSUB queued for submission 

CRAY> EXIT<RET> 

$ 



(2) $ CRAY SUBMIT MYSUB. JOB < RET > 

%CX-S-SUB_OK, Job: MYSUB queued for submission 

$ 
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Refresh Display Region 



Region Divider 



> 



dd-mmm-uyyu hh : mm:ss. cc Node name Current command page n 



Scrolled Command Region 



'35i 



Figure Command-1. Cray Context Refresh Style 



SV-0020 Command-26 



DATASET 

Reports the existence of a COS permanent dataset 

Format 



DATASET pdn 




Command Qualifiers 


Default 


/ED=ed 




/iD=userid 


None 


/OV=owner 




Availability 




When=LON DCL=YES 


Station=ANY 



Prompts 
DATASET pdn: 



Appropriate Input 
pdn 



Command Parameter 



pdn 



Name of permanent dataset for which status 
is requested; 1 through 15 characters (A 
through Z, through 9, or $, %. or @), the 
first character must be alphabetic. 



Description 

DATASET determines the existence of a permanent dataset on the Cray 
Computer System. The returned message is as follows: 

pdn WITH lD=userid AND ED=ed DOES( EXIST 

I NOT EXIST 



SV-0020 



Command-27 



Command Qualifiers 
/ED=ed 



/!D=userid 



Edition number of requested dataset; 1 
through 4095. If /ED is not specified, the 
status of the current highest edition number 
is returned. If ed is nonzero, the status 
of the requested edition is returned. 

User ID of permanent dataset for which 

chafiic to ronnocfaH' 1 t- Vi r- r\ 1 1 rrVi ft 

alphanumeric characters. If not specified, 
null is used. 



/OV=owner 



Owner value of the dataset 



Example 



$ CRAY DATASET/OV=U2105/ID=U2105 DATA<RET> 
DATA WITH ID=U2105 ED=1 OWNER=U2105 DOES EXIST 

$ 
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DELAY 

Suspends execution of an indirect station command file for a specified 
time 

Format 



DELAY seconds 




Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 

DELAY time in seconds: 



Appropriate Input 
seconds 



Command Parameter 



seconds 



Number of seconds allowed to elapse before 
processing the next command. This is a 
decimal integer in the range 1 through 
16,000. 



Description 

This command delays the execution of the next command within an indirect 
station command file. 



Example 

In this indirect station command file, DELAY causes a suspension of 30 
seconds before the JOB station command is executed. 

SUBMIT GETPDS.JOB 

DELAY 30 

COMMENT EXECUTION IS NOW SUSPENDED FOR 30 SECONDS 

JOB GETJOB 
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DISCARD 

Discards interactive output from COS 

Format 



DISCARD 




Command Qualifiers 


Default 


None 


None 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 



DISCARD allows the user to discard all output generated by the 
interactive job until the next COS prompt appears. 
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DROP 

Ends processing of a COS job, but saves the associated output dataset 

Format 



DROP jsq 




Command Qualifiers 


Default 


None 


None 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts Appropriate Input 

DROP jsq number: jsq 

Command Parameter 

jsq Job sequence number (JSQ) identifying job or 

dataset to COS; may be obtained through the 
STATUS command. 



Description 

DROP ends processing of a job at the Cray mainframe, but saves output 
dataset associated with the job. DROP causes the job to abort. Job 

execution continues with control statements encountered after the next 
EXIT control statement. 
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EOF 

Sends an end-of-file record to the current COS interactive job 

Format 



EOF 




Command Qualifiers 


Default 


None 


None 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

EOF sends a COS end-of-file (EOF) record to the Cray Computer System. 
This command is normally required to terminate COS file input from the 
terminal. 
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EXIT 

Returns the user from Cray context command mode to DCL command state 

Format 



EXIT 


Alternate Form 




CTRL/Z 


Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 

(See description) 



Appropriate Input 
None 



Command Parameters 



None 



Description 

EXIT returns the user from Cray context to DCL command state. If a 
RECORD command is issued during the session and the specified file is 
still open, the file is closed. As an alternative, the user can enter 
CTRL/Z in command mode to exit from Cray context. 

If the user is logged onto the Cray interactively when entering the EXIT 
command, the station provides warning that the user is logged on 
interactively and provides the option of returning to Cray context or 
exiting to DCL level. If the user chooses to exit, a BYE/SAVE station 
command is performed automatically. 



SV-0020 



Command- 3 3 



HELP 

Displays information from the station help files 

Format 



HELP [station-command] 




Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=YES 


Station=ANY 



Prompts 
Topic: 



Appropriate Input 

Station command/ <RET>, or CTRL/Z 



Command Parameter 



station-command 



Name of any station command available to 
normal users. The keyword HELP provides a 
syntax reference for all commands. Station 
commands specifically for operator use can 
be found by using the keyword "Operator." 



Description 

HELP provides text describing all user commands. If a command parameter 
is not specified after the HELP command, the system displays an index of 
all commands. To display a description of a specific station command, 
enter HELP plus a station-command. 

If the COS HELP feature in installed on the system, users can gain 
information about Cray JCL by entering HELP plus a specific COS library 
name, as in this example: 

$ HELP @COS<RET> 

Terminate the HELP session by pressing carriage return or CTRL/Z. 
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INTERACTIVE 

Initiates an interactive session 

Format 



INTERACTIVE 




Command Qualifiers 


Default 


/JH=<jobname> 




/MML=n 


/MML=5ite dependent value 


/[NO] UPPER 


/NOUPPER 


/US =<username> 




Availability 




When=LON DCL=YES 


Station=ATT 



Prompts 

Cray JOBNAME: 

Cray USERNAME: 



Appropriate Input 

jobname 

username 



Command Parameters 



None 



Description 

The INTERACTIVE command initiates or restarts an interactive session. 
The INTERACTIVE command can be entered after the CRAY> prompt when in 
Cray context refresh style. 

If the user does not enter the job name or user number qualifiers after 
the initial INTERACTIVE command, the station provides prompts for these 
values. 

Whenever the user enters interactive mode, a Cray interactive banner 
replaces the usual region divider. Station error messages are displayed 
during an interactive session in reverse video. 
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Description (continued) 

You can disconnect your VMS terminal from the COS job temporarily or 
permanently by the following process: 

1. Enter CTRL/Z after the interactive prompt to reenter Cray context 
command mode. 

2. Enter the BYE or QUIT station commands after the CRAY> prompt. 

The QUIT station command terminates both the session and the interactive 
job. The BYE station command/ without parameters, terminates the 
session, but does not terminate the associated interactive job. 



Command Qualifiers 

/JN=<jo2>name> 

/MML=n 



COS interactive job name; up to 7 characters 

Maximum message length. (This qualifier is 
site-dependent. For further information, 
refer to the DEC VAX/VMS Station 
Installation and Maintenance Reference 
Manual, CRI publication SV-0100.) 



/UPPER 
/NOUPPER 



/US =< username > 



Specifies whether input is converted to 
uppercase characters 

COS username; 1 to 15 characters. 



Examples 

(1) In this example, the jobname is TEST and the username is USER. 



$ CRAY < RET > 

CRAY> INTERACTIVE/ JN=TEST/US=USER< RET> 

(2) In example 2, the JN=j'o2>name or \JS=username parameters are not 

included after the INTERACTIVE command. As a result, the system 
provides prompts for these values. 



$ CRAY < RET > 

CRAY> INTERACTIVE < RET > 
Cray JOBNAME: TEST < RET > 
Cray USERNAME: USER < RET > 
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I STATUS 

Displays the status of the user's interactive job 

Format 



I STATUS 




Command Qualifiers 


Default 


None 


None 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

ISTATUS returns the CPU time used by the COS interactive job, the job 
status, and the last COS logfile message. 

Job status can be one of the following: 

AWAITING CPU 

AWAITING MEMORY 

DOES NOT EXIST 

DORMANT 

EXECUTING 

LOCKED 

QUEUED FOR EXEC 

QUEUED FOR RESOURCES 

ROLLED OUT 

ROLLING IN 

ROLLING OUT 

SUSPENDED 

WAITING FOR I/O 
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JOB 

Displays the status of a specific COS job 

Format 



JOB jobname 




Command Qualifier 


Default 


/JSQ=jsg 


None 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts 
JOB name: 



Appropriate Input 
jobname 



Command Parameter 



jobname 



COS job name for which status is requested 



Description 

The job status message returned by this command has the following general 
format: 

COS JOB jobname (job status) 
(last logfile message) 

Job status reports one of the following conditions: 

AWAITING CPU 

AWAITING MEMORY 

DOES NOT EXIST 

DORMANT 

EXECUTING 

LOCKED 

QUEUED FOR EXEC 

QUEUED FOR RESOURCES 

ROLLED OUT 

ROLLING IN 

ROLLING OUT 
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Description (continued) 

SUSPENDED 
WAITING FOR I/O 

The last logfile message is displayed unless the job status is DOES NOT 
EXIST or QUEUED FOR EXEC. 



Command Qualifier 

/JSQ=jsq jsq identifies the job sequence number 

from which to start the search for the job 
identified by jobname. 



SV-0020 Command- 3 9 



JSTAT 

Displays the status of a specific job and its related tasks 

Format 



JSTAT jsq 




Command Qualifiers 


Default 


/[NO] CYCLE 


/NOCYCLE 


/[NO] TRANSLATE 


/TRANSLATE 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts 

JSTAT jsq number: 



Appropriate Input 
jsq 



Command Parameter 



jsq 



COS job sequence number (JSQ) identifying 
the job or its output dataset to COS; it can 
be obtained through the STATUS command. 



Description 

JSTAT provides detailed information about a COS job. 



Command Qualifiers 

/CYCLE 
/NOCYCLE 



Specifies whether all information (/CYCLE) 
or only one page of information (/NOCYCLE) 
should be displayed when in refresh style. 
If the user specifies /CYCLE and there is 
more than one page of information, the page 
number is automatically controlled to save 
the user from entering + (page forward) and 
- (page backward) commands. /NOCYCLE is the 
default indicating that only one page of the 
refresh-style display is shown until the 
user enters the + or - commands. 
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Command Qualifiers (continued) 

/TRANSLATE 

/NOTRANSLATE Specifies whether the terminal ID field is 

translated to indicate VMS UIC. If not 
translated (/NOTRANSLATE), the terminal ID 
field is represented in the station internal 
form. 
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KILL 

Kills a COS job 

Format 



KILL jsq 




Command Qualifiers 


Default 


None 


None 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts Appropriate Input 

KILL jsq number: jsq 

Command Parameter 

jsq Job sequence number (JSQ) identifying the 

job or its output dataset to COS; it can be 
obtained through the STATUS command. 

Description 

Depending on the status of the COS job, KILL either deletes its input 
dataset from the input queue if processing has not yet begun, terminates 
processing if processing has begun, or deletes the job's output dataset 
from the output queue if processing is complete. KILL (unlike DROP) 
causes the job to terminate immediately. 
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LOGFILE 

Provides access to the station logfile messages 

Format 



LOGFILE [file-spec] 




Command Qualifiers 


Default 


/ACQUIRE 




/ALL 


/ALL 


/BEFORE=£ime 




/DISPOSE 




/ERROR 




/INTERACTIVE 




/JOB 




/MASTER 




/NETWORK 




/NODE =nodename 




/[NO] NOTIFY 


/NONOTIFY 


/OPERATOR 




/OUTPUT=f ile-spec 




/PRINT 




/RELEASE 




/SlNCE=time 




/SUCCESS 




/STMSG 




/[NO] TRANSLATE 


/TRANSLATE 


/\JSER=username 




Availability 




When=ANY DCL=YES 


Station=ANY 



Prompts 
None 



Appropriate Input 
None 
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Command Parameter 



file-spec 



A standard VAX/VMS file specification used 
to identify a logfile if not the current 
station logfile. 



Description 






to the station lo rr file* 



Command Qualifiers 
/ACQUIRE 

/ALL 
/BEFORE=time 



/DISPOSE 
/ERROR 

/INTERACTIVE 

/JOB 

/MASTER 

/NETWORK 

/NODE =nodename 



Displays messages related to acquire and 
fetch transfers 

Displays all messages that the user is 
allowed to see. VAX/VMS users with OPER 
privilege can see any entry. 

Defines latest time in which messages are of 
interest to the user (/SINCE qualifier 
defines earliest time) . Time can be in 
absolute time or combination time. Specify 
time using the standard syntax rules for 
specifying date and time given in the 
VAX/VMS DCL Dictionary, DEC publication 
AA-Z200A-TE. 

Displays messages related to dispose 
transfers 

Displays messages that are classified as 
errors. The effect is to exclude success, 
warning, and information messages. 

Displays messages related to interactive work 

Displays messages related to job submission 

Displays messages related to COS master 
operator station 

Displays messages related to DECnet 
communications 

Displays messages related to the specified 
DECnet nodename 
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Command Qualifiers (continued) 



/NOTIFY 
/NONOTIFY 



Specifies whether the system should provide 
notification that the requested operation 
(which is not synchronous) has completed. 
/NONOTIFY is the default for this command. 
This qualifier is only useful for the 
/RELEASE qualifier. 



/OPERATOR 



Displays messages related to operator 
commands 



/OUTPUT=f i 1 e-spec 



Specifies a file in which the list of 
messages that are currently being viewed are 
collected 



/PRINT 



Prints messages that are currently being 
viewed 



/RELEASE 



Closes the existing logfile and creates a 
new one 



/SINCE=time 



Defines earliest time at which station 
messages are of interest to the user 
(/BEFORE qualifier specifies latest time). 
Time can be in absolute time or combination 
time. Specify time using the standard 
syntax rules for specifying date and time 
given in the VAX/VMS DCL Dictionary, DEC 
publication AA-Z200A-TE. 



/SUCCESS 



Displays messages which are classified as 
success, warning, and informational. The 
effect is to exclude error messages. 



/STMSG 



Displays COS station messages and replies 



/TRANSLATE 
/NOTRANSLATE 



Specifies whether the terminal ID field is 
translated to indicate VMS UIC. If not 
translated (/NOTRANSLATE), the terminal ID 
field is represented in the station internal 
form. 



/USER=username 



Specifies that messages with the supplied 
username only are selected for display. 
Available only to VAX/VMS users with OPER 
privilege. 
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LOOP 

Restarts execution of an indirect station command file 

Format 



LOOP 




Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 



LOOP is used within an indirect station command file. The command 
restarts execution at the top of the file and causes looping. At the 
terminal, stop looping by entering CTRL/Z to terminate execution of the 
indirect station command file. 



Example 

An indirect station command file constructed with the following contents 
can be executed indefinitely: 

STATUS 
DELAY 20 
SHOW STATION 
DELAY 20 
LOOP 
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Example (continued) 

When this indirect station command file is executed in refresh-style 
Cray context, the system alternates between the STATUS and SHOW 
STATION displays at 20 second intervals. 
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MESSAGE 

Enters a message into the COS job logfile, the COS system logfile, or both 

Format 



MESSAGE string 




Command Qualifiers 


Default 


/BOTH 




/JN= j obname 




/JOB 


/JOB 


/JSQ=jsg 




/SYSTEM 




Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 

MESSAGE (qualifiers) text: 



Appropriate Input 

string [command qualifier] 



Command Parameter 



string 



Message to be entered into the COS job or 
system logfile; truncated to 79 characters, 
if necessary. Enclose in quotes to embed 
blanks in the message. 



Description 

MESSAGE allows users to enter a message to a COS logfile. The message 
may be sent to a job logfile, the COS system logfile, or both. The 
system also copies the message into the station logfile. 



Command Qualifiers 
/BOTH 



Specifies that the message goes to both the 
COS system logfile and the COS job; 
available only to VAX/VMS users with OPER 
privilege. 
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Command Qualifiers (continued) 
/ JN= jobname 



/JOB 



/ JSQ= jsq 



/SYSTEM 



jobname (combined with /JSQ=jsq) specifies 
the identity of the job for which a message 
is destined 

Specifies that the message goes to the COS 
job 

jsq (combined with /JN= jobname) specifies 
the identity of the job for which a message 
is destined 

Specifies that the message goes to the COS 
system logfile. A copy is also placed in 
the station logfile. This qualifier is 
available only to VAX/VMS users with OPER 
privilege. 
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PAUSE 

Suspends execution of an indirect station command file and switches 
control to the terminal 

Format 



DUTTCP 




Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 
PAUSE > 



Appropriate Input 

A carriage return or new command 



Command Parameters 



None 



Description 

PAUSE can be embedded in an indirect station command file. When PAUSE is 
encountered, the station suspends interpretation of commands from the 
indirect file and switches control to the terminal/ where the user can 
either terminate processing from the indirect station command file (by 
entering a command) or resume processing from the indirect file by 
entering a null command ( <RET> only). 
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PLAY 

Executes an indirect station command file 

Format 



play file-spec 


Alternate Form 




@ file-spec 


Command Qualifiers 


Default 


None 


None 


Availability 




When=ANY DCL=YES 


Station=ANY 



Prompts 

PLAY filename: 



Appropriate Input 
file-spec 



Command Parameter 



file-spec 



A standard VAX/VMS file specification 



Description 

PLAY initiates the execution of an indirect station command file that is 
created through use of the RECORD command or constructed by an editor. 
Indirect station command files provide users with a facility that 
parallels a VMS command procedure, that is, it provides a mechanism for a 
series of commands to be issued. Requested refresh displays can be 
observed for a period by including PAUSE and DELAY commands in the 
indirect station command file. 

The command currently being processed from the indirect station command 
file is shown at the terminal. 

Indirect station command files cannot contain PLAY commands. 
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Example 



$ CRAY/NOREFRESH<RET> 
CRAY> PLAY MYSUBS.PLA<RET> 

PLAY> COMMENT "Warm up" submits <RET> 

PLAY> SUBMIT J0B1<RET> 

%CX-S-SUB_OK, Job: WARM1 queued for submission 

PLAY> SUBMIT JOB 2 < RET > 

%CX-S-SUB_OK, Job: WARM2 queued for submission 
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QUIT 

Terminates an interactive session and the corresponding COS job 

Format 



QUIT 




Command Qualifiers 


Default 


None 


None 


Availability 




When=INT DCL=NO 


Station=ATT 



Prompts Appropriate Input 

None None 

Command Parameters 
None 



Description 

QUIT terminates an interactive session and also ends the corresponding 
COS interactive job. The effect of this command is identical to that of 
BYE/ABORT. If in refresh mode, the upper terminal region remains in 
interactive format until a new station display is entered. 



SV-0020 Command- 5 3 



RECORD 

Starts or stops the recording of terminal input for later use with the 
PLAY station command 

Format 



record [tile-spec] 




Command Qualifiers 


Default 


/OFF 




/ON 


/ON 


Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 

RECORD filename: 



Appropriate Input 
file-spec 



Command Parameter 



file-spec 



A standard VAX/VMS file specification 



Description 

This command records all commands issued until RECORD/OFF is issued or 
Cray context is terminated through the EXIT command. 



Command Qualifiers 
/OFF 

/ON 



Terminates command recording. When /OFF is 
specified, all other parameters or 
qualifiers are ignored. 

Initiates command recording. It is 
necessary to specify the file-spec 
parameter when /ON is specified. 
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RELEASE 

Releases a dataset held on the COS job queue 

Format 



RELEASE jsq 




Command Qualifiers 


Default 


None 


None 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts Appropriate Input 

RELEASE jsq number: jsq 

Command Parameter 

jsq COS job sequence number to be released; can 

be obtained through the STATUS command. 



Description 

This command releases a dataset that is held by COS and is waiting to be 
disposed. Datasets are held by COS when the VAX/VMS station detects that 
a disk-full or exceeded-quota condition exists while disposing a VMS 
file* VAX/VMS users with OPER privilege can release any entry that 
matches their station ID. VAX/VMS users without OPER privilege can 
release only their own datasets. 
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REMOVE 

Deletes entries in the VAX/VMS station dataset staging queue 

Format 



REMOVE I <q~id>\ 
1 ALL 1 




Command Qualifiers 


Default 


/[NO] LOCKED 


/NOLOCKED 


/SPOOL 




/STAGE 


/STAGE 


Availability 




When=ANY DCL=YES 


Station=ANY 



Prompts 

REMOVE q-id (or ALL) 



Appropriate Input 
q-id or ALL 



Command Parameters 



q-id 



ALL 



Indicates staging queue member to be 
deleted; an 8-character hexadecimal number 
that is determined using the SHOW QUEUES 
station command. Leading zeros in the 
identity number can be omitted. 

Removes all entries with the specified 
staging queue; available only to VAX/VMS 
users with OPER privilege. 



Description 

REMOVE deletes one or more entries in the VAX/VMS station dataset staging 
queue. However, if the entry is locked, indicating processing by COS has 
begun, the deletion is not carried out unless the /LOCKED qualifier is 
specified. 
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Description (continued) 

Where there is an associated file (that is, a job submission file), it is 
deleted. 

VAX/VMS users without OPER privilege can remove only their own entries. 



Command Qualifiers 



/LOCKED 
/NOLOCKED 



Specifies whether locked queue entries are 
removed. /NOLOCKED is the default. 



/SPOOL 



Specifies that the q-id is used to remove an 
entry in the network spooled dispose queue 



/STAGE 



Specifies that the q-id is used to remove an 
entry in the Cray staging queue 



Examples 

(1) $ CRAY REMOVE ALL < RET > 

Confirm removal of whole queue (Y/N): Y<RET> 
%CX-I-REM_ID, Staging queue entry 1000022A removed 
%CX-I-REM_ID, Staging queue entry 0A002259 removed 
$ 

(2) $ CRAY REMOVE 100010B4<RET> 

$ 

(3) $ CRAY REMOVE 1000AB05<RET> 

%CX-E-BAD_REML, Queue entry found locked, so not removed 

$ 
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RERUN 

Immediately ends processing of a COS job and reruns the job, if possible 

Format 



RERUN jsq 




Command Qualifiers 


Default 


None 


None 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts Appropriate Input 

RERUN jsq number: jsq 

Command Parameter 

jsq Job sequence number identifying the job to 

COS; obtained through the STATUS command. 



Description 

RERUN immediately ends processing of the job identified by its JSQ. The 
job input dataset at the Cray mainframe is saved and all output datasets 
associated with the job are deleted. The job input dataset is then 
rescheduled so the job can be rerun. No action is taken if the job 
execution is complete or if COS determines the job cannot be rerun. 
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SAVE 

Stages a single file to COS mass storage 

Format 



SAVE file-spec 




Command Qualifiers 


Default 


/BLOCKSIZE=n 




/DF=df 


/DF=CB 


/ED=ed 




/ EOF =eof 


/EOF="/EOF" 


/FOREIGN 




/ID=id 




/MN=mn 




/PDN=pdn 




/RD=rd 




/RT=rt 




/UNLOAD 




/US =user-number 




/VOLUME =< vol nam > , . . . 




/WT=wt 




Parameter Qualifiers 




/DELETE 




/ORG=BLK 




Availability 




When=ANY DCL=YES 


Station=ANY 



Prompt 
SAVE file: 



Appropriate Input 
file-spec 



Command Parameters 



file-spec 



A VAX/VMS file to be staged to the Cray 
Computer System. Incomplete file 
specifications are resolved by using the 
user's defaults. The file-spec may be 
qualified as follows: 
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Command Parameters (continued) 

file-spec 
(continued) 



/DELETE The file is deleted after it 
is successfully staged to the 
Cray Computer System. The 
only file qualifier used when 
using SAVE from a VMS disk 
file. 

/ORG=BLK This qualifier is required if 
the tape is read in 
interchange format. The only 
file qualifier used when using 
SAVE from a tape file. 

These file qualifiers must be appended to 
the file-spec and not to the SAVE 
command itself. 



Description 

SAVE queues a request for the VAX/VMS station to stage a dataset to the 
Cray Computer System. At the Cray Computer System, the dataset is 
entered onto a Cray mainframe mass storage device. 



Command Qualifiers 
/BLOCKSIZE=n 

/DF=df 



Specifies the maximum block size for 
interchange format tapes 

Dataset format; can be CB, BB, or TR. The 
default is CB. 



/ED=ed 



Optional qualifier allowing the user to 
specify the edition number. If not 
specified, COS allocates a number. The ed 
string must be a decimal integer between 
and 4095. 



/ EOF =eof 

/FOREIGN 
/ID=id 

/MN=mn 



Specifies the string to be used as an 
end-of-file mark; the default is "/EOF". 

Required for interchange format tapes 

Optional qualifier allowing the user to set 
a user identification of 1 through 8 
alphanumeric characters 

Maintenance control word 
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Command Qualifiers (continued) 
/PDN=pdn 



/RD=rd 
/RT=rt 
/UNLOAD 

/\JS=user-number 
/ VOLUME =< vol nam > , 



/WT=w£ 



Sets the name of the dataset to the 
(uppercase) alphanumeric string pdn. If 
this qualifier is omitted, the input file 
name is used, trunctated to 15 characters. 

Read permission control word 

Retention time in number of days 

Volume is unloaded physically from the tape 
unit when staging is complete 

COS user number 

Volume name or names for a multivolume tape 
set. Must be specified when the source file 
is on tape. The station requests that each 
volnam in the VOLUME list is loaded until 
it finds the specified filename. It then 
reads subsequent volumes until the total 
file is staged. 

Write permission control word 



Examples 



(1) 



(2) 



(3) 



(4) 



$ CRAY SAVE NEWFILE.DAT<RET> 

%CX-S-SAV_OK, PDN: NEWFILE queued for saving 

$ 

$ CRAY SAVE/PDN=TEMP MYTEMP. DAT/DELETE < RET > 
°*CX-S-SAV_OK, PDN: TEMP queued for saving 
$ 

$ CRAY SAVE/VOLUME=TRND/UNLOAD MTAO: WEATHER ,DAT< RET > 

%CX-S-SAV_OK, PDN: WEATHER queued for saving 

$ 

$ CRAY SAVE/VOLUME=TURNS/FOREIGN/BLOCK=4096 - 

MTAO : EVENTS . TAP/ORG=BLK< RET> 
%CX-S-SAV_OK, PDN: EVENTS queued for saving 
$ 
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SET TERMINAL 

Sets the terminal working environment 

Format 



SET TERMINAL parameter [■■ 


=value] 


Command Qualifiers 


Default 


None 


None 


Command Parameters 




[NO] FORTRAN 


NOFORTRAN 


[NO] INFORM 


NOINFORM 


[NO ] PAGE [=lines] 


NOPAGE 


[NO ] REFRESH [ =seconds ] 


REFRESH 


SCROLL=lines 




WIDTH=5"ize 




Parameter Qualifiers 




/ALL 




/STMSG 




Availability 




When=ANY DCL=NO 


Station=ANY 



Prompts 

SET TERMINAL parameter: 



Appropriate Input 
command parameter 



Command Parameters 

FORTRAN 
NOFORTRAN 



Specifies whether FORTRAN carriage control 
characters are received. The parameter is 
useful in COS interactive mode when the 
output record contains FORTRAN carriage 
control characters. If the user specifies 
the FORTRAN command parameter and no valid 
FORTRAN carriage control character is found, 
the record is output followed by a new line. 
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Command Parameters (continued) 



INFORM 
NOINFORM 



Specifies whether station messages are sent 
to users logged on to VMS at a VAX 
terminal. These messages provide 
information on the progress of a user's work 
on the Cray Computer System. VAX/VMS users 
with OPER privilege can use the parameter 
qualifiers /ALL and /STMSG for this 
parameter. 

/ALL Available only to VAX/VMS users 
with OPER privilege; permits 
users to receive all station 
information broadcasts about 
their own node (excluding COS 
station messages). 

/STMSG Available only to VAX/VMS users 
with OPER privilege. Indicates 
that users should be informed of 
COS station messages. 



PAGE [=lines] 
NOPAGE 



Specifies whether COS interactive output is 
to be continuous with no page breaks. 
lines is a decimal integer that defines 
the number of lines of Cray interactive 
output in a page. lines specifies when 
the user must enter a carriage return to 
receive the next page of interactive 
output. The default is determined by the 
SCROLL setting. 



REFRESH [=seconds ] 
NOREFRESH 



Specifies whether Cray context screen 
formatting is in refresh or nonrefresh 
(line-by-line) style. Refresh style is 
supported only on terminals with the DEC_CRT 
attribute. seconds defines the rate at 
which the screen refreshes occur in Cray 
context refresh style. seconds requires 
that the VAX/VMS user has OPER privilege. 
Specify the refresh rate interval as a 
decimal integer in the range through 60 
seconds. 
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Command Parameters (continued) 

SCROLL=lines Alters the proportion of the video screen 

devoted to command input. This command 
parameter can only be used in refresh-style 
Cray context. lines is the size of the 
command scroll region, which is a decimal 
integer from 3 through 13. The default is 4 

WIBTK=5'ize Resets the terminal width. Current 

information in the scrolled command region 
is lost. Size is the number of characters 
per line (80 or 132). The default is 80. 



Description 

SET TERMINAL sets the terminal working environment. 
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SHOW QUEUES 

Displays entries in the VAX/VMS station dataset staging queue 

Format 



SHOW QUEUES 






Command Qualif 


iers 


Default 


/ACQUIRE 




/ALL 


/ALL 






/[NO] CYCLE 




/NOCYCLE 


/JOB 






/NODE=node-id 






/OWNER 






/SAVE 






/SPOOL 




/SPOOLt 


/STAGE 




/STAGE 


/[NO] TRANSLATE 




/TRANSLATE 


Availability 






When=ANY 


DCL=YES 


Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 



SHOW QUEUES displays the entries in the dataset staging queue to COS 
Use the command qualifiers /JOB, /SAVE, and /ACQUIRE to see specific 
queue entry categories. 



f Default only for VAX/VMS users with OPER privilege 
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Description (continued) 

The following information is provided in this display: 

• Position in staging queue. The number in column 1 indicates the 
relative position of the entry in the queue. The letter L in 
column 1 indicates that it is locked and therefore being processed. 

• Request type 

• Queue identity (q-id). This hexadecimal number is used in the 
REMOVE and REQUEUE commands. 

• VAX username 

• Dataset transfer name (job) 

• Terminal identifier (TID) associated with dataset. If the 
/TRANSLATE qualifier form is used, information is provided on the 
DECnet node and VAX/VMS UIC. 



Command Qualifiers 
/ACQUIRE 

/ALL 



Specifies that dataset requests originating 
from COS (through ACQUIRE or FETCH 
statements) are included in the display. 

Specifies that all types are included in the 
display (that is, /ACQUIRE, /JOB, and /SAVE) 



/CYCLE 
/NOCYCLE 



/OWNER 



/JOB 



Specifies whether all information (/CYCLE) 
or only one page of information (/NOCYCLE) 
should be displayed when in refresh style. 
If the user specifies /CYCLE and there is 
more than one page of information, the page 
number is automatically controlled, making 
it unnecessary to enter the + (page forward) 
and - (page backward) commands. /NOCYCLE is 
the default, indicating that only one page 
of the refresh-style display will be shown 
until the user enters the + or - commands. 

Specifies that the queued entries owned by 
the user are displayed 

Specifies that job submissions resulting 
from use of the SUBMIT command are displayed 
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Command Qualifiers (continued) 



/NODE=node-id 



Specifies only entries from a particular 
DECnet node, node-id is the DECnet node 
name displayed when the user enters the 
VAX/ VMS DCL command SHOW NETWORK. This 
qualifier is only useful at the attached 
VAX/VMS station. 



/SAVE 



Specifies that dataset save requests 
resulting from use of the SAVE command are 
displayed 



/SPOOL 



Specifies that network spooled disposes only 
are included in the display. This qualifier 
has no affect unless the user has the 
VAX/VMS OPER privilege. 



/STAGE 



Specifies that the Cray staging entries are 
included in the display 



/TRANSLATE 
/NOTRANSLATE 



Specifies whether the terminal identifier 
field is translated to indicate VMS UIC. If 
not translated (/NOTRANSLATE), the TID field 
is represented in the station internal form. 
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SNAP 

Copies the display screen image to a VAX/VMS file 

Format 



SNAP file-spec 

Command Qualifiers 
/[NO] ESCAPE 
Availability 
When=ANY DCL=NO 



Default 



/NOESCAPE 



Station=ANY 



Prompts 

SNAP filename: 



Appropriate Input 
file-spec 



Command Parameter 



file-spec 



A standard VAX/VMS file specification 



Description 

SNAP is available only within Cray context. If the terminal is in 
refresh style, the command records the current contents of the display 
region and region divider. The display is stored in the file specified 
in file-spec. If the command is issued from a terminal in nonrefresh 
style, the last display requested is recorded in the file. 



Command Qualifiers 

/ESCAPE 
/NOESCAPE 



Specifies whether screen controlling escape 
sequences are to be removed from the screen 
image recorded. Escape sequences are 
available only in refresh-style Cray context 
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STATUS 

Displays COS status 

Format 



STATUS 






Command Qualif 


iers 


Default 


/ALL 




/ALL 


/ CLASS =jcn 






/[NO] CYCLE 




/NOCYCLE 


/EXECUTING 




/EXECUTING 


/HOLD 






/ID=id 






/INPUT 




/INPUT 


/NODE=node-id 






/OUTPUT 




/OUTPUT 


/OWNER 






/RECEIVING 




/RECEIVING 


/SENDING 




/SENDING 


/[NO] TRANS LATE 




/TRANSLATE 


/VAX 






Availability 






When=LON 


DCL=YES 


Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 

STATUS returns the status of jobs, input datasets, and output datasets 
known to COS. Several jobs are reported at a time according to their job 
sequence numbers. Status can be requested for any or all of the COS job 
queues. The display header shows the current COS job class name. 
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Description (continued) 

The following information is provided in a status display for each COS 
dataset: 

• Job sequence number (JSQ) 

• Disposition code (DC), as follows: 

T1/" 1^~ -. -. — i ■***- i **■*% 

IN Job dataset 

MT Dataset is to be disposed to magnetic tape at the 
receiving station 

PR Dataset is to be disposed to a printer at the receiving 
station 

PT Dataset is to be disposed to a plotter at the receiving 
station 

PU Dataset is to be disposed to punched cards at the 
receiving station 

ST Dataset is to be made a permanent dataset at the 
receiving station or other Cray mainframe 

• Job name when submitted at originating station 

• Job class assignment 

• Job or dataset status, as follows: 

Status Description 

EXECUTE Executing 

HOLDING Dataset held on COS 

LOCK-MEM Locked by memory 

LOCK-SYS Locked by system 

QUEUED Queued for execution 

QUEUED-T Queued for tape 

RESIDENT Resident in memory (multitasking job) 

ROLL-IN Rolling in 

ROLLED Rolled out 

SUSP-OPR Suspended by operator 

SUSP-RCY Recovery suspended 

WAIT-1TH Suspended to single thread tasks (multitasking job) 
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Description (continued) 



Status 



Description 



WAIT-EVT Waiting for event 

WAIT-I/O Waiting for I/O 

WAIT-MEM Waiting for memory 

WAIT-SYS System suspended 

WAIT-TIM Waiting for time event 

WAIT-TSK Suspended by task deactivate (multitasking job) 

WAIT-XFR Waiting to transfer 

WAIT-CPU Waiting for CPU 

XFER-IN Transferring into Cray 

XFER-OUT Transferring out of Cray 

• Priority displayed as two fields. The integer field gives the 
assigned priority, and the fractional field gives the calculated 
priority. 

• Time used in seconds and time limit in seconds (decimal). If the 
job's time used or time limit exceeds the display area, the 
corresponding entry contains ****. if time used or time limit is 
not applicable for the dataset, the corresponding entry contains 



• Field length of job specified as a decimal count of 512-word 
blocks. If field length is not applicable, the entry contains 



• Station ID associated with job or dataset 

• Terminal identifier (TID) associated with job or dataset. If the 
/TRANSLATE qualifier is used, the DECnet node and VAX/VMS UIC 
information is provided. 



Command Qualifiers 



/ALL 



Specifies that all COS status display 
entries may be viewed 



/CLASS =jcn 



Specifies that the entry with this 
7-character job class name be displayed 



/CYCLE 
/NOCYCLE 



Specifies whether all information (/CYCLE) 
or only one page of information (/NOCYCLE) 
should be displayed when in refresh style. 
If the user specifies /CYCLE and there is 
more than one page of information, the page 
number is automatically controlled, making 
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Command Qualifiers (continued) 



/CYCLE 

/NOCYCLE 

(continued) 



it unnecessary to enter the + (page forward) 
and - (page backward) commands. /NOCYCLE is 
the default, indicating that only one page 
of the refresh-style display is shown until 
the user enters the + or - commands. 



/EXECUTING 



Specifies that the status of the execution 
queue be displayed 



/HOLD 



Specifies that only COS datasets that are 
currently held on the COS hold queue are 
shown 



/ID=id 



Specifies the COS station identity of a 
specific front-end station 



/INPUT 



Specifies that the input queue status be 
displayed 



/NODE = node- id 



Specifies entries from a particular DECnet 

node. node-id is the DECnet node name 

shown in the VAX/VMS DCL command SHOW NETWORK 



/OUTPUT 



Specifies that the output queue status be 
displayed 



/OWNER 



Restricts the status information to only 
those entries owned by the user 



/RECEIVING 



Specifies that the status of the Cray 
mainframe receiving queue be displayed 



/SENDING 



Specifies that the status of the Cray 
mainframe sending queue be displayed 



/TRANSLATE 
/NOTRANSLATE 



Specifies whether the terminal identifier 
field is translated to indicate VMS UIC. If 
not translated (/NOTRANSLATE), the TID field 
is represented in the station internal form. 



/VAX 



Specifies that only work originating from 
this VAX/VMS station (or network of 
stations) is shown 
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SUBMIT 

Stages a job to COS for processing 

Format 



SUBMIT <file-spec> 




Command Qualifiers 


Default 


/AFTER=£ime 




/EOF (=<eof>) 


/EOF="/EOF M 


/[NO] PRINT 


/NOPRINT 


/OUTPUT=f i 1 e-spec 




Availability 




When=ANY DCL=YES 


Station=ANY 



Prompts 
SUBMIT file: 



Appropriate Input 
file-spec 



Command Parameter 



file-spec 



Name of one or more input files to be staged 
to COS. If no file type is specified, the 
station default file type is used. (This is 
normally .JOB, but this value may be changed 
by the station manager at an installation. ) 
The first file must contain COS JCL commands. 

In reply to a prompt for files, more than 
one file can be specified on the same line, 
but files must be separated by commas or 
plus signs. A group of files to be regarded 
as just one file by COS should be separated 
by plus signs. Commas separating files 
indicate that COS end-of-file markers should 
be placed between each file. Prompting 
allows input of an indefinite sequence of 
files, until a null entry (carriage return) 
is received. It is assumed that the first 
file mentioned on a line is separated from 
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Command Parameters (continued) 



file-spec 
(continued) 



the last file of the previous line by a 
comma, unless a plus sign has been 
explicitly used. 

Specify files in the format defined in the 
VAX/VMS DCL Dictionary, DEC publication 
AA-Z200A-TE. 

SYS$INPUT is a special file-spec allowing 
the user to enter text not already placed in 
a file. This file-spec initiates an 
immediate entry mode of operation for either 
batch or interactive users. Input must be 
terminated by CTRL/Z. SYS$INPUT must be 
placed at the end of a line of input. 



Description 

SUBMIT constructs a job submission file that is queued for staging to 
COS. SUBMIT creates the job submission file from input files. COS 
<eof> separators are automatically inserted unless files are separated 
by plus signs overriding the <eof>. COS <eof> and end-of-data 
indicators terminate the file. 

After it is run, job and logfile output is staged back to the directory 
from which it was submitted with the filename ' job- name. CPR' . 



Command Qualifiers 
/AFTER= time 



/EOF =<eof> 



Specifies when the job is to be sent to the 
Cray Computer System. time is represented 
in absolute time or combination time. 
Specify time using the VAX/VMS standard 
syntax rules found in the VAX/VMS DCL 
Dictionary, DEC publication AA-Z200A-TE. 

Specifies the embedded COS <eof> separator 
contained in VMS files submitted to COS. If 
the user does not specify the value <eof>, 
the station uses the default <eof> 
separator /EOF. When <eof> is specified, 
it is a 1- to 80-character ASCII string 
defining the COS <eof> separator. 
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Command Qualifiers (continued) 



/EOF=<eof > 
(continued) 



If nonalphanumeric characters are in the 
string, they must be enclosed in quotation 
marks (for example, /EOF= M E O F"). 



/PRINT 
/NOPRINT 



/OUTPUT=f i 1 e-spec 



Determines whether print files associated 
with this COS job are printed. If the user 
specifies /NOPRINT, the file is stored in a 
VMS file in the directory from which the job 
was submitted. If the user specifies 
/PRINT, the file is deleted after being 
spooled to the default print queue. 

Specifies where COS job output is placed. 
Allows user to override default file 
specification information determined at job 
submission with specific disk and/or 
directory information. 



Examples 
(1) 



$ CRAY SUBMIT MYFIL. JOB < RET > 

%CX-S-SUB_OK, Job: EXAMPLE queued for submission 
$ 



This example stages the file MYFIL. JOB to COS. If the VMS file 
contains several COS files, the files are separated by records 
containing /EOF. 



(2) $ CRAY SUBMIT/NOPRINT<RET> 

SUBMIT File: CRAY JOB. JOB < RET > 

SUBMIT File: <RET> 

^oCX-S-SUBJDK, Job: FRED queued for submission 

$ 

Example 2 indicates the prompted dialogue equivalent to: 

$ CRAY SUBMIT/NOPRINT CRAY JOB. JOB < RET > 

^>CX-S-SUB_OK, Job: FRED queued for submission 
$ 



(3) $ CRAY SUBMIT/NOPRINT/EOF= ,, **** ,, MY JOB. JOB < RET > 
%CX-S-SUB_OK, Job: JIM queued for submission 
$ 

Example 3 indicates the file MYJOB.JOB is subdivided by the end of 
file string "****" 
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Examples (continued) 

(4) $ CRAY SUBMIT SYS$ INPUT < RET > 

JOB,JN=LATEST.. . 



Z 

%CX-S-SUB_OK, Job: LATEST queued for submission 

In example 4, the JCL file is entered at the terminal 
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SWITCH 

Manipulates the job sense switches 

Format 



SWITCH jsq ssw 




Command Qualifiers 


Default 


/OFF 




/ON 


/ON 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts 

SWITCH jsq number: 

SWITCH ssw number: 



Appropriate Input 

jsq 

ssw 



Command Parameters 



jsq 



ssw 



Job sequence number identifying the job to 
COS; displayed with the STATUS command. 

Sense switch number; 1 through 6. 



Description 

SWITCH sets or clears a job sense switch. Sense switches can be used for 
program synchronization on the Cray Computer System. 



Command Qualifiers 
/OFF 

/ON 



Clears the switch designated by ssw. When 
/OFF is specified, all other parameters or 
qualifiers are ignored. 

Sets the switch designated by ssw 
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TAPE 

Displays COS tape device information 

Format 



TAPE 




Command Qualifiers 


Default 


/[NO] CYCLE 


/NOCYCLE 


Availability 




When=LON DCL=YES 


Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 

TAPE displays the following configuration information for each tape 
device: 

• Device number 

• Generic device name 

• All access paths 

• Associated JSQ (if any assigned) 
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Description (continued) 

• Device status, as follows: 



Status 

DOWN 

IDLE 

MAINTENANCE 

OFFLINE 

OP - DOWN 

OP . INTERVNTN 

READ 

RD/WT 

SYS - DOWN 



Description 

Device is down; not available for use. 

Available for use 

Maintenance mode; not available for use. 

Offline; not available for use. 

Downed by the operator; not available for use, 

Operator intervention required. 

Currently assigned to a job; write disabled. 

Currently assigned to a job; write enabled. 

Downed by the system; not available for use. 



• Density, as follows: 

6250 bpi 
1600 bpi 

• Assigned volume serial number 



Command Qualifiers 

/CYCLE 
/NOCYCLE 



Specifies whether all information (/CYCLE) or 
only one page of information (/NOCYCLE) should 
be displayed when in refresh style. If the user 
specifies /CYCLE and there is more than one page 
of information, the page number is automatically 
controlled, making it unnecessary to enter the + 
(page forward) and - (page backward) commands. 
/NOCYCLE is the default, indicating that only 
one page of the refresh-style display is shown 
until the user enters the + or - commands. 
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TJOB 

Displays the status of COS tape jobs 

Format 



TJOB 

Command Qualifiers 
/[NO] CYCLE 
Availability 
When=LON DCL=YES 



Default 



/NOCYCLE 



Station=ANY 



Prompts 
None 



Appropriate Input 
None 



Command Parameters 



None 



Description 

TJOB displays the status of jobs requiring tape devices. The TJOB 
display provides the following information: 

• Job sequence number 

• Disposition code, as follows: 

IN Job dataset 

MT Dataset is to be disposed to magnetic tape at the receiving 

station 
PR Dataset is to be disposed to a printer at the receiving 

station 
PT Dataset is to be disposed to a plotter at the receiving 

station 
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Description (continued) 

PU Dataset is to be disposed to punched cards at the receiving 

station 
ST Dataset is to be made a permanent dataset at the receiving 

station 

• Job name 

• Job status, as follows: 



Status 



Description 



DELAY Waiting for time event 

EXCTNG Executing 

HOLDING Waiting for release 

LOCKED Locked because of system incompatibility 

Q-EXEC Queued for execution 

Q-TAPE Queued for tape 

R-IN Rolling in 

ROLLED Rolled out 

R-OUT Rolling out 

S-CPU Waiting for CPU 

S-EVENT Waiting for event 

S-MEM Waiting for memory 

S-OP Operator suspended 

S-RECV Recovery suspended (SHUTDOWN) 

S-SYS System suspended 

S-XFER Waiting for transfer 

XFERING Transfer in progress 

Job priority 

Time used in seconds and time limit in seconds (decimal). If the 
job's time used or time limit exceeds the display area, the 
corresponding entry contains ****. if time used or time limit is 
not applicable for the dataset, the corresponding entry contains 



• Field length of job specified as a decimal count of 512 word 
blocks. If field length is not applicable, the entry contains 



• Station ID associated with job 
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Command Qualifiers 

/CYCLE 

/NOCYCLE Specifies whether all information (/CYCLE) or 

only one page of information (/NOCYCLE) should 
be displayed when in refresh style. If /CYCLE 
is specified and there is more than one page of 
information, the page number is automatically 
controlled/ making it unnecessary to enter the - 
(page forward) and - (page backward) commands. 
/NOCYCLE is the default, indicating that only 
one page of the refresh-style display is shown 
until entry of the + or - commands. 
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APPENDIX SECTION 



SAMPLE TERMINAL SESSIONS 



This appendix provides two sample terminal sessions in which you use the 
VAX/VMS station to prepare, submit/ and monitor jobs that are sent to the 
Cray Computer System for processing. These sample terminal sessions draw 
together activities that are discussed in sections 2 through 7. 

Each sample terminal session is divided into three stages: 

1. Preparing the job file or job files on the VAX-11 front-end. 

2. Submitting the job to the Cray Operating System (COS) with the 
SUBMIT station command; monitoring the job with other station 
commands . 

3. Managing the returned job output on the VAX-11 front-end. 

These three stages are eguivalent to the steps of job preparation, 
submission, and management described in section 3. 

This appendix assumes that you can log on to VAX/VMS and use a text 
editor to prepare a job file on the front-end computer system; if you 
cannot, refer to the list of publications in the preface. 

These sample terminal sessions provide you with basic models to prepare, 
submit, monitor, and manage COS jobs. After you complete these sample 
terminal sessions, use the Command Reference section of this publication 
and the CRAY-OS Version 1 Reference Manual, publication SR-0011, to 
tailor COS jobs to your specific reguirements. 



A.l FIRST TERMINAL SESSION - MINIMUM JCL 

In this sample terminal session you will submit a single job file that 
contains the minimum Cray JCL necessary for processing by COS. 
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A. 1.1 PREPARING THE JOB FILE 

The first stage of preparing a job for COS processing is to create a file 
on the VAX-11 front-end computer system. Use EDT or another VAX/VMS text 
editor to enter the following job control statements and FORTRAN code 
into file SAMPLE. JOB. (Explanatory notes follow.) 

JOB , JN= jobname . 

ACCOUNT, AC=accoun£#,US=userid,UPW=userpassword. 

CFT. 

LDR. 

EXIT. 

/EOF 

J=50 

DO 10 1=1,10 

J=J+1 

PRINT 50, J 
10 CONTINUE 

STOP 
50 FORMAT ( ' ',13) 

END 
/EOF 

The first five lines of this file are the minimum JCL required for job 
submission. They are briefly explained below: 

Statement Description 

JOB, JtH= jobname JOB control statement, which defines the job 

name you wish to assign to this job. 
jobname can be from 1 to 7 alphanumeric 
characters; the Cray Computer System returns 
your job output to your directory with the 
format joiname.CPR. 

ACCOUNT, hC=account#,\JS=userid,UPVl=userpassword. 

ACCOUNT control statement, which identifies 
your account number, user ID, and user 
password to the system. You will obtain 
these values when you open an account with 
the Cray Computer System. 

CFT. CFT control statement, which brings the CFT 

compiler into execution. 

LDR. LDR control statement, which calls the COS 

relocatable loader into execution. 
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Statement Description 

EXIT. Indicates the point in the JCL file where 

processing of control statements resumes 
following a job step abort from a program. 
If no job step abort occurs, the EXIT control 
statement indicates the end of JCL processing, 

The end of the JCL file is indicated in line 6 with an end-of-file record 
(/EOF). FORTRAN statements begin in column 7. In this example, FORTRAN 

line numbers begin in column three. The final statement in the file is 
indicated with an end-of-file record (/EOF). 

When you have prepared your file on the VAX front-end, you are ready to 
submit and monitor the job for processing on the Cray Computer System. 



A. 1.2 SUBMITTING AND MONITORING THE JOB 

Before submitting your job to the Cray Computer System, determine if the 
station is operating by using the station command SHOW QUEUES. (If you 
are entering station commands after the DCL prompt, all station commands 
must be preceded by CRAY. See section 2 for a discussion of entering 
station commands.) 

$ CRAY SHOW QUEUES < RET > 

Station queue: STAGING 28-0CT-1984 13:52:12.12 

Acquires OPEN Jobs OPEN Saves OPEN Disposes OPEN 

req q-id username job tid 

spooled 

In this example, the station responds that it is transmitting with the 
Cray Computer System by displaying "STAGING". (If the station is not on 
and staging, your jobs are placed in the station staging queue until they 
can be submitted to the Cray Computer System.) Because you have not yet 
submitted a job, the final line of the example indicates that no entries 
are found to display. 

Use the SET TERMINAL INFORM station command to enable the sending of 
station messages to your display terminal. These messages provide 
information relevant to the progress of your work on the Cray Computer 
System. 

$ CRAY SET TERMINAL INFORM<RET> 
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To submit your job file from the VAX-11 front-end computer system to the 
Cray Computer System, use the SUBMIT station command, followed by the 
name of the file you are submitting. In this example, you will submit 
file SAMPLE. JOB, which you prepared previously. 

$ CRAY SUBMIT SAMPLE. JOB < RET > 

If your job submission is successful, the system returns a message like 
the one below. 

^CX-S-SUBJDK, Job: jobname queued for submission 

jobname is the jobname you defined with the JN= parameter of the JOB 
statement in the first line of your sample program. 

Now that you have used the SUBMIT station command, use SHOW QUEUES again 
to check the job's position in the staging queue. 

$ CRAY SHOW QUEUES < RET > 

Station queue: STAGING 28-0CT-1984 13:52:21.12 

Acquires OPEN Jobs OPEN Saves OPEN Disposes OPEN 

req q-id username job tid 

L JB 7A480011 WHITE CRAYJOB CRAYMH [WHITE] 

In this example, user WHITE has job TEST on the staging queue to COS. 
Your own user name, job name, terminal ID, and other values appear on the 
queue display. 

Because you used the SET TERMINAL INFORM command, the station soon begins 
sending messages that inform you about the progress of your job. For 
example: 

$ 

VAX TO CRAY: %RMS-S -NORMAL, normal successful completion 

VAX TO CRAY: FILE = CRAYJOB. SUB; 1 

VAX TO CRAY: 4096 BYTES TRANSFERRED 

$ 

This set of messaqes indicates that your job has been sent from the 
VAX-11 front-end to the Cray Computer System. 

To monitor processing on the Cray Computer System, enter the STATUS 
command. 

$ CRAY STATUS 

Cray system status 

jsq dc dataset class status pri used limit length id tid 

4519 IN CRAYJOB NORMAL EXECUTE 13.9 3 9 39 DX [WHITE] 
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To determine if your job is currently executing, look under "status" in 
column 5. In the above example, the submitted dataset CRAYJOB is 
executing, indicated by "EXECUTE". 

Now use the JOB station command to display the lines most recently 
written to your job's logfile: 

$ CRAY JOB CRAYJOB < RET > 

COS JOB CRAYJOB IS EXECUTING 

LDR. 

%CX-S-JOB_OK, JOB request return JSQ=4519 

The example logfile confirms that COS has begun to process the job. 

When the Cray Computer System has finished executing a job, the station 
displays another set of messages indicating that the job has been sent 
from the Cray Computer System to the VAX front-end: 

$ 

CRAY TO VAX: %RMS-S -NORMAL, normal successful completion 

CRAY TO VAX: FILE=UMA1 : [WHITE ] CRAYJOB. CPR; 1 

CRAY TO VAX: 3608 BYTES TRANSFERRED 

$ 

In this example, line 3 indicates that the output from the job is placed 
in user WHITE'S file CRAYJOB. CPR; 1. When you receive the output from 
COS, it appears under the directory from which you submitted the job with 
a filename identical to the job name; the default file type is .CPR. For 
example, if you specified your job name as TESTJOB, the system returns 
your job to a file under your directory with the name TESTJOB. CPR. 



A. 1.3 MANAGING JOB OUTPUT 

Now that your job has completed processing, use the VAX/VMS command TYPE 
or EDIT to display your job output file at your terminal. You can also 
print your file with the PRINT command. 

See the next terminal session for a description of how to read your 
program output. 
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A. 2 SECOND SAMPLE TERMINAL SESSION - DATASET STAGING 

In the first sample terminal session, you submitted a single job file to 
the Cray Computer System. The file contained the minimum JCL required 
for processing and did not stage datasets from the front-end computer 
system or create permanent datasets on COS mass storage. 

This second terminal session provides you with a slightly more complex 
example. There are three primary differences between this sample session 
and the first sample session: 

• Rather than store your Cray JCL and FORTRAN program code in one 
VAX/VMS file, you will store them in two separate files. You will 
use the SUBMIT station command to send only the JCL file to the 
Cray Computer System; the file containing the FORTRAN code is 
staged to the Cray Computer System by an ACQUIRE statement 
contained in the JCL file you submit. 

• You will use the AUDIT job control statement to provide a status 
report of the permanent dataset your program stores on the system. 

• Following program execution, the permanent dataset created on the 
Cray mainframe is returned to the front-end system by a DISPOSE 
control statement contained in your JCL file. 



A. 2.1 PREPARING THE JOB FILES 

In this subsection, you will prepare two job files on the VAX-11 
front-end system. The first file (which is named JCL. JOB) contains Cray 
JCL; the second file (which is named FORTRAN. CFT) contains the FORTRAN 
code. 

Use EDT or another VAX/VMS text editor to enter the following statements 
into file JCL. JOB. (Explanatory notes follow.) 

JOB , JN= < j obname > . 

ACCOUNT, AC =< account #>,US=< user id>,UPW=< use rpas sword > . 

ACQUIRE, DN=CFTFILE,TEXT=' FORTRAN. CFT', ID=< user id>,UQ. 

AUDIT. 

CFT,I=CFTFILE. 

LDR. 

DISPOSE, DN=CFTFILE , TEXT= ' RETURN. CFT/RAT=CR ' . 

EXIT. 

/EOF 

The JOB and ACCOUNT statements have the same function as in the first 
sample program. The remaining 8 lines of the file are explained below: 
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Statement Description 

ACQUI RE , DN=CFTFILE / TEXT=* FORTRAN. CFT' / ID=< use rid>,UQ. 

Stages the file FORTRAN. CFT from the VAX 
front-end to the Cray Computer System, 
assigning it the local and permanent dataset 
name of CFTFILE. Later in this JCL file, 
CFTFILE is compiled by the CFT statement and 
staged back to the front-end system with the 
DISPOSE control statement. 

AUDIT. Provides a report on the status of each 

permanent dataset owned by the user that is 
known to the system. The report should 
include the permanent dataset CFTFILE, which 
was created with the previous ACQUIRE 
statement. 

CFT, I=CFTFILE. Brings the CFT compiler into execution; 

I=CFTFILE designates CFTFILE as the dataset 
on which the compiler executes. 

LDR. Calls the COS relocatable loader into 

execution. 

DISPOSE, DN=CFTFILE,TEXT=' RETURN. CFT/RAT=CR' . 

Stages the local dataset CFTFILE from the 
Cray Computer System to the VAX front-end. 
The TEXT= parameter instructs the station to 
place the dataset under your default VAX/VMS 
directory with the file specification 
RETURN. CFT. (After the FORTRAN code in 
CFTFILE is compiled and loaded, it is no 
longer required by this example program; 
CFTFILE is staged to the front-end computer 
system in this example program only for the 
purpose of demonstrating DISPOSE 
processing. ) The /RAT=CR qualifier specifies 
that each record is to be preceded by a line 
feed and followed by a carriage return. 

EXIT. Indicates the point in the JCL file where 

processing of control statements resumes 
following a job step abort from a program. 
If no job step abort occurs, the EXIT control 
statement indicates the end of JCL processing, 

An end-of-file record (/EOF) in line 9 indicates the end of the JCL file. 
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To create the FORTRAN file, enter the following code into a VAX/VMS file 
named FORTRAN. CFT. (You can also use the VAX/VMS COPY command to copy 
the file from the previous sample terminal session into FORTRAN. CFT. ) 

J=50 

DO 10 1=1,10 

J=J+1 

PRINT 50, J 
10 CONTINUE 

STOP 
50 FORMATC ',13) 

END 
/EOF 

FORTRAN statements begin in column 7. FORTRAN line numbers begin in 
column 3. An /EOF marker follows the program and signals end of data. 

When you have prepared files JCL.JOB and FORTRAN. CFT on the VAX front-end 
system, you are ready to submit them to the Cray Computer System for 
processing. 



A. 2. 2 SUBMITTING AND MONITORING THE JOB 

Before submitting your job, use the SHOW QUEUES station command to 
determine if the station is on and staging. Then turn on information 
broadcasting by using the SET TERMINAL INFORM station command. The first 
sample terminal session explains both of these station commands. 

In this sample terminal session, you will send file JCL.JOB (which 
contains your program JCL) to the Cray Computer System; file FORTRAN. CFT 
(which contains your FORTRAN code) is staged to the Cray Computer System 
by the ACQUIRE statement contained in file JCL.JOB. To submit file 
JCL.JOB, use the SUBMIT command as shown below: 

$ CRAY SUBMIT JCL. JOB < RET > 

If your job submission is successful, the system returns a message like 
the one below. 

%CX-S-SUB_OK, Job: <jobname> queued for submission 

<jobname> is the job name you defined with the JN= parameter of the JOB 
statement in the first line of your sample program. 

Now that you have submitted your job to the Cray Computer System, use 
SHOW QUEUES to check the job's position in the staging queue. 
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$ CRAY SHOW QUEUES < RET > 

Station queue: ON+STAGING 28-0CT-1984 13:52:12.12 

Acquires OPEN Jobs OPEN Saves OPEN Disposes OPEN 

req q-id username job tid 

L JB 7A480011 CASTLE TEST CRAYMH [CASTLE] 

In this example, user CASTLE has job TEST on the staging queue to COS. 
Your own user name, job name, and other values will appear on the queue 
display. 

Use the JOB station command, described in the first sample terminal 
session, to determine the line most recently written to your job's 
logfile. 

Because you used the SET TERMINAL INFORM station command, the station 
soon begins sending messages that inform you of the progress of your job. 

$ 

VAX TO CRAY: %SYSTEM-S -NORMAL, normal successful completion 

VAX TO CRAY: FILE = JCL.J0B;1 

VAX TO CRAY: 4096 BYTES TRANSFERRED 

$ 

VAX TO CRAY: %SYSTEM-S -NORMAL, normal successful completion 

VAX TO CRAY: FILE = <disk> : [ <directory > ]FORTRAN. CFT; 1 

VAX TO CRAY: 4096 BYTES TRANSFERRED 

$ 

The first set of messages indicates that your job has been sent from the 
VAX front-end to the Cray Computer System. The second set of messages 
indicates that the file FORTRAN. CFT; 1 was successfully staged from the 
VAX front-end to the Cray Computer System. (Staging of the file 
FORTRAN. CFT; 1 was accomplished by the ACQUIRE control statement contained 
in your JCL file.) Your own values for <disk> and <directory> will 
appear in the second set of messages. 

To monitor processing of your job on the Cray Computer System, enter the 
STATUS station command. To determine if your job is currently executing, 
look under "status" in column five. 

$ CRAY STATUS 

Cray system status 

jsq dc dataset class status pri used limit length id tid 

4519 IN CRAY JOB NORMAL EXECUTE 13.9 3 9 39 DX [CASTLE] 

In the above example, the submitted dataset CRAYJOB is executing, as 
indicated by "EXECUTE". 
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The station continues to send messages that inform you of the progress of 
your job. 

$ 

CRAY TO VAX: %RMS-S -NORMAL, normal successful completion 

CRAY TO VAX: FILE=<disk> : [ <directory> ]RETURN.CFT; 1 

CRAY TO VAX: 117 BYTES TRANSFERRED 

$ 

CRAY TO VAX: %RMS-S -NORMAL, normal successful completion 

CRAY TO VAX: FILE=<disk> : [ <directory> ] jobname .CPR; 1 

CRAY TO VAX: 3608 BYTES TRANSFERRED 

$ 

The first set of messages indicates that the dataset containing your 
FORTRAN code has been sent from the Cray Computer System to the VAX 
front-end; this was accomplished by the DISPOSE statement in your JCL 
file. Your own values for <disk> and <directory> appear in the message. 
The second set of messages indicates that the output file from your job 
has been transferred to your directory on the VAX front-end; your Cray 
job is finished. The job output appears in the directory from which you 
submitted the job with the following format: 

< jobname > . CPR 

You specified <jobname> with the JN= parameter of the JOB control 
statement in line 1 of your JCL file. 



A. 2. 3 READING JOB OUTPUT 

This subsection describes how to read the job output file that COS 
returns to the front-end computer system. Use the VAX/VMS commands TYPE 
or EDIT to display your job output file at your terminal. You can also 
print your file with the VAX/VMS command PRINT. 

The first page of your COS program output contains a report on permanent 
datasets stored on the Cray Computer System; this report appears only 
when you include the AUDIT control statement in your JCL file. By using 
available parameters, the AUDIT control statement can report on numerous 
variables, including: 



Permanent dataset name 

Dataset identifier 

Edition number 

User identification 

Creation date/time 

Last access date/time 

Last modified date/time 

Last dumped date/time 

Device name on which dataset resides 
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Because you used system defaults for the AUDIT statement in your JCL 
file, the AUDIT report in your job output appears similar to figure A-l. 



AUDIT COS 1.14 10/30/84 14:21:50 Page 

OWN = U2105 



PDN ID ED LAST LAST LAST DEVICE 

SZ RT ACC TA PAM CREATED ACCESSED MODIFIED DUMPED 



CFTFILE 1 11/29/84 10/07/84 10/07/84 49-A2-24 

512 45 3 N N 10:02:17 10:03:23 10:05:45 

1 DATASET, 1 BLOCK, 602 WORDS 



Figure A-l. AUDIT Report 



The next page of your program output contains a header line and a listing 
of your executable FORTRAN code. The FORTRAN code is assigned line 
numbers, as in the following example: 



1 


1. 




J=50 


2 


2. 




DO 10 1=1,10 


3 


3. 




J=J + 1 


4 


4. 




PRINT 50, J 


5 


5. 


10 


CONTINUE 


6 


6. 


50 


FORMAT ( ' * ,1 


7 


7. 




STOP 


8 


8. 




END 



The results of your program appear on the bottom of the following page, 
under the heading TOTAL. In your sample terminal session, your results 
will appear as follows: 

TOTAL : 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
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The logfile for your job appears at the end of the job output. The 
logfile is an abbreviated history of the progress of your job through the 
Cray Computer System. Each job control statement is listed sequentially, 
followed by any message associated with the job step. Clock time, 
accumulated CPU time, and COS information are also given for each job 
step. 

The numbered headings below describe each part of the job logfile. Refer 
to your own jobfile output as you read this description. 

1. First header line ; Appears on the top, right corner of the 
logfile; an installation-defined message, usually identifying the 
site and date the job was run. 

2. Second header line : Appears below the first header line; an 
installation-defined message, usually identifying the operating 
system, its current revision level, and the date of the last 
revision. 

3. Columns ; Appear on the left side of the logfile. The leftmost 
column identifies the wallclock time for each job step and the 
middle column identifies the accumulated CPU time for the job. 
The rightmost column identifies a system module or the user as 
the originator of the message. (All times are in decimal.) 
Entries commonly noted include the following: 

CSP Control Statement Processor 

PDM Permanent Dataset Manager 

EXP Exchange Processor 

ABORT Abort Message 

USER Program in user field 

4. Control statements : Control statements appear below the second 
header line. 

5. Logfile messages ; Any messages related to control statement 
processing appear below each control statement. For example: 

ACQUI RE, DN=CFTF I LE,TEXT=' FORTRAN. CFT' , ID=<userid> . 

PDOOO - PDN = CFTFILE ID = <userid> ED = 1 OWN = U2105 

PD000 - ACCESS COMPLETE 

In this example, line 1 is the ACQUIRE control statement as it 
appears in your JCL file. Line 2 is the logfile message, which 
specifies permanent dataset name, ID, edition, and owner. Line 3 
verifies that the ACQUIRE statement access was successful. 
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6. Accounting information ; Appears on the bottom, left corner of 
the logfile, below the control statements and logfile messages. 
When a job reaches completion, COS writes a summary of basic 
accounting data onto the logfile for the job. All times given 
are in hours, minutes, and seconds (to the nearest ten-thousandth 
of a second) . The following accounting information is provided 
(in decimal) : 

Job name and user number 



CPU time used by the job and by each job task in a 
multitasked job step 

Time waiting to execute, for the job and for each job task 
in a multitasked job step; includes time waiting for the 
CPU, memory, operator suspension, and recovery. 

Time waiting for I/O, for the job and for each job task in a 
multitasked job step 

Time waiting in input queue 

Memory usage based on the execution and I/O wait time in 
million word-seconds 

Minimum and maximum job size including Job Table Area (JTA) 
(words) 

Minimum and maximum field length used (words) 

Minimum and maximum JTA used (words) 

Number of 512-word disk blocks (sectors) moved 

Number of user I/O requests made by the job 

Open and close calls 

Memory-resident datasets 

Number of 512-word disk blocks (sectors) used for temporary 
datasets 

Number of 512-word disk blocks (sectors) accessed and saved 
for permanent datasets 

Number of 512-word disk blocks (sectors) received from and 
queued to the front end 

Number of tape devices reserved; message issued only if 
magnetic tape datasets have been processed. 
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• Number of tape volumes mounted; message issued only if 
magnetic tape datasets have been processed. 

• Amount of tape data moved, expressed as a multiple of 512 
words; message issued only if magnetic tape datasets have 
been processed. Each disk sector consists of 512 words, and 
in COS blocked format each block consists of 512 words. 

• Number of tape blocks moved; message issued only if magnetic 
tape datasets have been processed. 

7. System bulletin : The system bulletin allows the installation to 
print messages in the logfile, usually about the status of the 
system environment. It is an installation-maintained message 
dataset. 

See the COS Version 1 Reference Manual, publication SR-0011, for a 
detailed discussion of reading job output files. 
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NEW AND CHANGED 
STATION COMMANDS 



B 



The VAX/VMS station has been enhanced considerably for version 3. As a 
result, several version 2 user station commands have been replaced by new 
and changed station commands in version 3. Table B-l compares the 
version 2 user station commands with their counterparts in version 3 of 
the station. Note that table B-l does not outline the extended command 
capabilities of version 3 of the VAX/VMS station. 

See the end of this section for a list of user station commands that are 
new to version 3 of the VAX/VMS station. 



Table B-l. Version 3 Counterparts of Version 2 
Station Commands 



Version 2 


Version 3 


Station Commands 


Station Commands 


+ 


+ 


@ 


(? 


$ 


$ 


ABORT 


ABORT 


ATTENTION 


ATTENTION 


BYE 


BYE 


CLEAR 


CLEAR 


COLLECT 


COLLECT 


COMMENT 


COMMENT 


CRAY 


CRAY 


DATASET 


DATASET 
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Table B-l. Version 3 Counterparts of Version 2 
Station Commands (continued) 



Version 2 


Version 3 


Station Commands 


Station Commands 


DELAY 


DELAY 


DISCARD 


DISCARD 


DROP 


DROP 


ECHO 


ECHO 


EOF 


EOF 


EXIT 


EXIT 


GETLOG 


LOGF I LE /OUTPUT 


HELP 


HELP 


INFORM 


SET TERMINAL INFORM 


INTERACTIVE 


INTERACTIVE 


I STATUS 


I STATUS 


JOB 


JOB 


KILL 


KILL 


MESSAGE 


MESSAGE 


PAGE 


SET TERMINAL PAGE 


PAUSE 


PAUSE 


PLAY 


PLAY 


QUEUE 


SHOW QUEUES 


QUIT 


QUIT 


RECALL 


Withdrawn 


RECORD 


RECORD 
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Table B-l. Version 3 Counterparts of Version 2 
Station Commands (continued) 



Version 2 


Version 3 


Station Commands 


Station Commands 


REFRESH 


SET TERMINAL REFRESH 


REMOVE 


REMOVE 


RERUN 


RERUN 


SAVE 


SAVE 


SCROLL 


SET TERMINAL SCROLL 


SNAP 


SNAP 


STATCLASS 


Withdrawn for users 


STATUS 


STATUS 


SUBMIT 


SUBMIT 


SWITCH 


SWITCH 


TIME 


Withdrawn for users 


TSTATUS 


TAPE 


WIDTH 


SET TERMINAL WIDTH 



The following user station commands are new to version 3 of the VAX/VMS 
station. Note that several of these commands have counterparts in 
version 2 of the station. 



• 


ATTACH 


• 


CHOOSE (site -dependent) 


• 


JSTAT 


• 


LOGFILE 


• 


LOOP 


• 


RELEASE 


• 


SET TERMINAL 


• 


SHOW QUEUES 


• 


TAPE 


• 


TJOB 
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GLOSSARY 



GLOSSARY 



Access protection - In the context "system, owner, group, world," files 
may be protected as to read, write, execute, and delete privileges by 
category. See also: group, owner, system, and world. 

ACQUIRE - A COS job control statement that causes the specified dataset 
to be transferred from the front-end computer system to the Cray computer 
system and made a permanent dataset. 



Binary Blocked (BB) Dataset Format - Contains ASCII character data, block 
control words (BCWs), and record control words (RCWs). 

BLK - Block mode file organization. 

Blocked dataset format - A fixed number of contiguous characters preceded 
by a block control word as the first word of a block. 

Block I/O file - A VMS sequential or random access file that contains a 
series of numbered records. Each record in the file corresponds to one 
physical block on the storage device. The record size varies depending 
on the storage medium. 

Block mode - Mode in which data is processed in data lengths equal to the 
physical blocksize of the device. 

Block size - Physical block size of the device. For disk device, 512 
bytes; for magnetic tape device, 14 to 32,768 bytes. 



Character blocked (CB) dataset format - Contains ASCII character data, 
block control words (BCWs), record control words (RCWs), and optional 
blank compression characters. 

Command mode - A scrolled terminal environment that facilitates command 
selection. Two display styles are available: refresh and nonrefresh. 
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Command qualifier - A keyword that modifies a station command and 
provides additional information on how the command should be executed. A 
qualifier is always preceded by a slash character (/). 

COS - Cray Operating System. 

Cray context - A command state that provides users with a command 
selection mechanism, a refreshed display capability, and a gateway to COS 
interactive processing. Most VAX/VMS station commands are available both 
at DCL level and from within Cray context. However, a subset of commands 
related to refreshed display and interactive processing are available 
only within Cray context. 

Cray mainframe - The CRAY X-MP or CRAY-1 computer systems. 



D 

DCL - Digital Command Language. 

Directory - A group of VMS files stored on a disk. 

DISPOSE - A COS control statement that causes the specified dataset to be 
transferred from COS mass storage to VMS disks or tapes. 

Disposition code (DC) - A code used in ACQUIRE, DISPOSE, and FETCH 
processing to indicate the disposition to be made of a dataset staged to 
or from the Cray computer system. 



FAB - See File Access Block. 

FETCH - A COS job control statement that causes the specified dataset to 
be transferred from the front-end computer system to the Cray Computer 
System. The dataset remains local to the job requesting the VMS dataset, 

File Access Block (FAB) - A RMS user data structure that describes a 
particular file and contains file-related information needed for data 
operations. 

File descriptor - An optional element in the TEXT field of an ACQUIRE, 
FETCH, or DISPOSE control statement consisting of an ASCII string 
uniquely identifying the target file on the specified device. 

File name - A 1- to 9-character component of a VMS file specification. 

File organization - Data arrangement with a file. The VAX/VMS station 
supports binary blocked (BB), character blocked (CB), and transparent 
(TR) organization. 
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File qualifier - A keyword that modifies the operation of a command by 
giving further specification. A qualifier is always preceded by a slash 
character. 



Group - In the context "system, owner, group, world," group refers to a 
set of VMS users who have special access privileges to each other's 
directories and the files within those directories. 



M 

Maximum record size (MRS) - File qualifier that depends on record type: 
for fixed-length records, the actual size of each record; for 
variable-length records, the largest record that can be written to the 
file; for relative files, this value determines the size of the record 
cell. 

MRS - See maximum record size. 



N 

Nonrefresh style - Available within Cray context command mode; provides 
command selection in a terminal -independent manner. Display request 
commands issued in nonrefresh style produce single snapshot displays. 





$OUT - A dataset that contains the list output unless the user designates 
some other dataset. At job end, the job logfile is added to the $OUT 
dataset and the dataset is sent to the front-end computer system. 

ORG - See organization. 

Organization - File arrangement. The VAX/VMS station recognizes block 
mode, relative organization, and sequential organization. 

Owner - An owner, in the context "system, owner, group, world," is the 
particular member of a group to which a file global section, mailbox, or 
event flag cluster belongs. 



Q 

Queuename - In staging commands, the queuename specifies the queue to 
which the job is submitted. 
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R 

RAT - The file qualifier that initializes control information pertaining 
to records of the file. 

Record file mode - The VAX/VMS station supports fixed-length (FIX) record 
format and variable-length (VAR) record format. 

Refresh display region - In a Cray context split-screen working 
environment/ the refresh display region is the top part of the display 
screen. Display request commands produce a refreshed display on this 
part of the screen. 

Refresh style - A command mode within Cray context; available only to 
terminals with the DEC advanced video option. 

Region divider - In the split-screen working environment, the screen has 
two regions; the lower part is a scrolled command region and the top part 
is a refreshed display region. The two screen regions are divided by a 
region divider that presents the summary information about the current 
session. 

REL - See relative file organization. 

Relative file organization - File organization in which fixed-length 
records are written to an RMS relative record format file sequentially, 
starting at relative record 1. 

RFM - See record file mode. 

RMS - Record Management Services (RMS), which is used to open and close 
files, read from files, write to files, and extend and delete files. 



Scrolled command region - In the Cray context split-screen working 
environment, the scrolled command region is the bottom half of the 
display screen. Users enter commands here in response to the CRAY> 
prompt . 

SEQ - File organization in which records are written sequentially to an 
RMS sequential access file. 

Split screen working environment - In Cray context refresh style command 
mode, the screen is split into two regions; the lower part is a scrolled 
command region and the top part is a refreshed display region where 
displays are available. 

Station - The combination of VAX hardware and software, and the CRI 
supplemental software. 
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Symbiont - A full process that transfers record-oriented data to or from 
a mass storage device. For example, an input symbiont transfers data 
from card readers to disks; an output symbiont transfers data from disks 
to line printers. 

System - In the context "system, owner, group, world," system refers to 
the group members that are used by the operating system and its 
controlling users, the system operators, and the system manager. 

SYS$ INPUT - Input device associated with the process. 

SYS $ PR I NT - Default line printer queue for a particular VAX. 



TEXT field - An ASCII string used in a COS control statement that 
provides information for the dataset transfer. 

TIP - Terminal identifier field in control statements used by the VAX/VMS 
station for the VAX user identification code. 

Transparent (TR) dataset format - An ASCII bit string. 



U 

UIC - See user identification code. 

UNI BUS - A DEC hardware component. An asynchronous bidirectional pathway 
within a VAX to which various system components and peripherals connect. 

User identification code - The pair of numbers assigned to users and to 
files, global sections, comment event flag clusters, and mailboxes that 
specify the type of access available to the owners, group, world, and 
system. 



V 

VAX - A computer system manufactured by Digital Equipment Corporation 
(DEC). 



W 

World - In the context "system, owner, group, or world," world refers to 
all users, including the system operators, the system manager, and users 
both in an owner's group and in any other group. 
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INDEX 



$ station command, Command-10 

+ station command, Coramand-7 

- station command, Command-8 

@ station command, Command-9 



Abbreviation of commands, Command-2 
ABORT 

interactive station command, 7-2 

station command, Command-12 
/ABORT station command qualifier, Command-16 
ACCOUNT COS control statement, A-2 
Accounting information, A-13 
ACQUIRE COS job control statement 

central discussion, 6-1 through 6-8 

examples, 4-13 

format, 4-2, 6-1 

staging commands, 6-2 
/ACQUIRE station command qualifier 

LOGFILE, Command-43 

SHOW QUEUES, Command-65 
Advanced video facilities, 7-6 
/AFTER 

$PRINT command qualifier, 5-18 

station command qualifier, Command-73 

$SUBNIT command qualifier, 5-15 
/ALL station command qualifier 

LOGFILE, Command-43 

SHOW QUEUES, Command-65 

STATUS, Command-69 
Alternate devices, Command- 13 
ATTACH 

interactive station command, 7-2 

station command, Command- 13 
Attached station, 1-1 
ATTENTION 

interactive station command, 7-2 

station command, Command-15 
AUDIT 

COS job control statement, A-6 

report, A-ll 
Auditing COS permanent datasets, A-10 
Availability codes, Command-1 



BB dataset format, 5-1 

/BEFORE station command qualifier, 
Command-43 

Binary blocked dataset format, 4-8 

Block 

control words, 4-7 

mode processing, 5-7 

size of magnetic tapes, 5-10 



/BLOCKSIZE 

station command qualifier, 
Command-59 

$TAPE command qualifier, 6-6 
/BOTH station command qualifier, Command-48 
/BURST $PRINT file qualifier, 5-20 
BYE 

interactive station command, 7-2 

station command, Command-16 



Carriage return characters, 5-8 

CB dataset format, 4-7, 5-1 

CFT COS control statement, A-2 

Character blocked dataset format, 4-7, 5-1 

/CHARACTERISTICS $PRINT command qualifier, 

5-18 
/CHAR station command qualifier, Command- 13 
CHOOSE station command, Command-17 
Choosing Cray computer systems, 2-17 
/CLASS station command qualifier, Command-69 
CLEAR station command, 2-14, Command-19 
COLLECT 

interactive station command, 7-2 

station command, Command-20 
Commands (see station commands) 
Command 

mode , 2-9 

procedures, 2-16 

scroll area, 7-6 
Commas (separating COS job files), 

Command-73 
COMMENT station command, Command-22 
Completion status code, 2-16 
Control Statement Processor (CSP), 

Command-12 
Controlling messages (commands for), 2-6 
Conventions, 1-4 

/COPIES $PRINT file qualifier, 5-20 
COS (see Cray Operating System) 
CPU time, Command-37, A-13 
/CPUTIME $SUBMIT command qualifier, 5-15 
Cray computer system selection, 2-17 
Cray context 

command mode, 2-9 

DCL mode, 2-12 

entry, Command-24 

interactive mode, 2-11 

return user from, Command-33 

use of, 2-8 
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Cray Operating System (COS) 

displaying status of, Command-69 

logfile message, Command-37, Command-48 

interactive processing (see 
interactive processing) 

record blocking, 4-1 

transparent datasets, 4-8 

See also job processing (COS), ACCOUNT, 
ACQUIRE, CFT, DISPOSE, EXIT, FETCH, 
LDR, and SAVE 
CRAY station command, Command- 24 
CSP, Command- 12 

CTRL/Z station command, Command- 11 
/CYCLE station command qualifier 

central discussion, 2-14 

JSTAT, Command-40 

SHOW QUEUES, Command-65 

STATUS, Command-69 



Display 

header, Command-69 

refreshment, Command-24 

screen image, Command-68 
Displaying information, 2-5 
DISPOSE COS job control statement 

central discussion, 5-1 

defaults, 4-11 

examples, 4-12, 5-9 

staging commands, 5-3 
/DISPOSE station command qualifier, 

Command-43 
Disposition code 

DISPOSE, 4-5, 4-10 

STATUS, Command-70 

TJOB, Command- 80 
DROP station command, Command-31 



Dataset 

auditing, A-ll 

defaults for jobs not originating from 
the station, 4-14 

formats 

ACQUIRE, 4-3, 6-1 

central discussion, 4-7 

DISPOSE, 4-5, 5-1 

FETCH, 4-4, 6-1 

SAVE station command, command-60 

identification, 4-6 

management, 4-1 

release from COS job queue, Command-55 

releasing from COS job queue, Command-55 

reporting existence of, Command-27 

staging (see staging) 

staging queue, Coramand-56, Command-65 

status, Command-70 

transfer name, Command-66 
DATASET station command, Command-27 
DCL 

codes, Command- 2 

command entry, Command-10 

level command entry, 2-8 

mode, 2-12 
Deblocking datasets, 5-1 
DEC_CRT facility, 2-10, Command-63 
DELAY station command, Comraand-29 
/DELETE $PRINT file qualifier, 5-20 
Destination file types, 4-10 
Device status, Command-79 
/DEVICE $PRINT command qualifier, 5-18 
/DF station command qualifier, Coramand-59 
DISCARD 

interactive station command, 7-2 

station command, Command-30 
$DISK 

ACQUIRE/ FETCH staging command, 6-3 

command qualifiers, 5-4, 6-3 

DISPOSE staging command, 5-3 

file 

descriptor, 5-4, 6-3 
qualifiers, 5-6, 6-5 



Edition number (COS dataset), Command-60 
/ED station command qualifier, Command-59 
End-of-file 

record, Command-32 

separators, 3-3 
EOF 

interactive station command, 7-2 

station command, Command-32 
/EOF 

staging command qualifier, 5-4 

station command qualifier 
SUBMIT, Command-73 
SAVE, Command-59 

$TAPE command qualifier, 6-6 
/ERROR station command qualifier, Command-43 
/ESCAPE station command qualifier, 

Command-68 
/EXECUTING station command qualifier, 

Command-69 
EXIT 

COS control statement, A-3 

station command, Command-33 
Expiration date for magnetic file tape, 5-11 
/EXPIRY $TAPE command qualifier, 5-11 



/FEED $PRINT file qualifier, 5-20 
FETCH COS job control statement 

central discussion, 6-1 

examples, 4-13 

format, 4-2 

staging commands, 6-2 
/FLAG_PAGE $PRINT file qualifier, 5-20 
/FOREIGN 

COS JCL qualifier, 4-8 

station command qualifier, 
Command-59 

$TAPE command qualifier, 6-6 
/FORM $PRINT command qualifier, 5-18 
FORTRAN 

carriage control characters, 5-8, 
Command- 14, Comraand-62 

command parameter, Command-62 

interactive example, 7-8 
/FORTRAN station command qualifier, 
Command- 13 
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GETLOG station command (version 2), B-2 
Graphical output redirection, Command-13 



Hardware configuration, 1-3 

/HEADER $PRINT file qualifier, 5-20 

HELP 

facility, 2-2, 2-13 

files, Command-34 

station command, Command-34 

/HOLD 

$PRINT command qualifier, 5-18 
station command qualifier, Command-69 
$SUBMIT command qualifier, 5-15 

HYPERchannel network, 1-3 



I/O 

requests, A- 13 

subsystem, 5-8 
/IDENTIFY $SUBMIT command qualifier, 5-15 
/ID station command qualifier 

SAVE, Command-59 

STATUS, Command-69 
IN disposition code, 4-10, 5-1 
Indirect station command file 

commands for using, 2-7 

execution, Command- 9, Command-51 

looping, Command-45 

pausing, Command-50 

recording, Command-54 

suspending execution, Command- 29 

switching control to the terminal, 
Command-50 
INFORM 

command parameter, Command-62 

station command (version 2), B-2 
Input 

datasets, Command-42, Command-69 

queue (COS), Command-42 
/INPUT station command qualifier, Command-69 
Interactive facilities (COS) 

central discussion, 7-1 

command description, Command-35 

commands for, 2-5, 7-2 

discarding output, Command-30 

displaying status of, Command- 37 

entry, 7-3, Command-35 

example, 7-4 

exiting, 7-3 

interruption, Command-12, Command-15 

redirection of terminal output, 
Command-13 

sending end-of-file records, Command-32 

storing output in a VMS file, Command-20 

terminal output redirection, Command-13 

termination, Command- 16, Command-53 
INTERACTIVE 

interactive station command, 7-2 

station command, Command-35 
/INTERACTIVE station command qualifier, 

Command- 43 
Interchange format, 4-8, 5-10, Command-60 



ISTATUS 

interactive station command, 7-2 
station command, Command-37 



/JN command qualifier, Command-48 
Job 

class 

assignment, Command-70 
name, Command-69 
control language (COS) 

examples of usage, 3-1, A-l 
See also ACCOUNT, ACQUIRE, CFT, 
DISPOSE, EXIT, FETCH, JOB, LDR, 
and SAVE 
sense switches, Command-77 
submission file, Command-74 
Job processing (COS) 

central discussions, 3-1, Command-73 
displaying status, Command-40, 

Command-38 
ending processing, Command-30 
examples, 3-2 through 3-6, A-l 
terminating, Command-42 
management , 3-2 
preparation, 3-2, A-2 
rerunning, Command-58 
status, Command-37, Command-38, 

Command-80 
See also interactive facilities (COS) 
JOB 

COS control statement, A-2 
station command, Command-38 
Job Table Area (JTA), A- 13 
/JOB station command qualifier 
LOGFILE, Command- 43 
MESSAGE, Command-48 
SHOW QUEUES, Command-65 
JSTAT station command, Command-40 



/KEEP $SUBMIT command qualifier, 5-15 
KILL station command, Command-42 



LDR COS control statement, A-2 

Line feed, 5-8 

/LOCKED station command qualifier, 

Command-56 
Log off (VMS), 1-5 
Log on (VMS), 1-5 
Logfile messages (COS) 

access , Command-43 

entering, Command-48 

example, A- 12 
LOGFILE station command, Command-43 
/LOGFILE $SUBMIT command qualifier, 5-15 
LOGOUT command, Command- 10 
LOOP station command, Command- 46 
/LOWERCASE $PRINT command qualifier, 5-19 



Magnetic file tape, 5-1 
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Mainframe identifier 

ACQUIRE, 4-3, 6-1 

DISPOSE, 4-5, 5-1 

FETCH, 4-4, 6-1 
Maintenance control word, 4-3, Conunand-60 
/MASTER station command qualifier, 

Command- 43 
Maximum 

block size, Command-60 

record size 
$DISK, 5-4 
$TAPE, 5-14 
Memory usage, A- 13 
Memory-resident datasets, A- 13 
MESSAGE station command, Command-48 
/MN station command qualifier, Command- 5 9 
/MRS 

file descriptor qualifier, 5-8 

station command qualifier, Command- 13 
MT disposition code, 4-10, 5-1 



/NAME 

$PRINT command qualifier, 5-19 

$SUBMIT command qualifier, 5-16 
Network spooled disposes, Command-67 
/NETWORK station command qualifier, 

Command-43 
/NOCYCLE station command qualifier, 2-14 
/NODE station command qualifier 

LOGFILE, Command-43 

SHOW QUEUES, Command-65 

STATUS, Command-69 
Nonrefresh style Cray context, 2-10 
/NOREFRESH qualifier, 2-10 
/OPERATOR station command qualifier, 

Command-43 
/NOTIFY 

$PRINT command qualifier, 5-19 

$SUBMIT command qualifier, 5-16 



Open and close calls, A-13 

OPER privilege, Command-55, Command-63 

/ORG 

$DISK file qualifier, 5-7 

$TAPE file qualifier, 5-13, 6-7 
$OUT (COS), 4-11 
Output 

datasets, Command-30, Commands-69 

queue status, Command-72 
/OUTPUT station command qualifier 

LOGFILE, Command-43 

STATUS, Command-69 

SUBMIT, Comraand-73 
/OWNER station command qualifier 

SHOW QUEUES, Command-65 

STATUS, Command-69 



PAGE 



command parameter, Command-62 
station command (version 2), B-2 



Page 

breaks (COS output), Command-63 

size of COS output, 7-7 
/PAGE_COUNT $PRINT file qualifier, 5-20 
/PARAMETERS $SUBMIT command qualifier, 5-16 
PAUSE station command, Command-50 
/PDN station command qualifier, Command-59 
Permanent dataset (see dataset) 
Physical connection, 1-3 
PL disposition code, 4-10, 5-1 
Play files (see indirect station command 

files) 
PLAY station command, Command-51 
Plus signs, Command- 73 
PR 

datasets, 4-11 

disposition code, 4-10, 5-1 
Print files, Command-75 
$PRINT 

DISPOSE staging command, 5-17 
command qualifiers, 5-18 
file descriptor, 5-19 
file qualifiers, 5-20 
/PRINT station command qualifier 

LOGFILE, Command-43 

SUBMIT, Command- 73 
/PRINTER $SUBMIT command qualifier, 5-16 
Priority, Command- 71 
/PRIORITY 

$PRINT command qualifier, 5-19 

$SUBMIT command qualifier, 5-16 
Program synchronization, Command-77 
/PROTECTION 

$DISK file descriptor 
qualifier, 5-6 

$TAPE file qualifier, 5-13 
PU disposition code, 4-10, 5-1 
Publications, iii 



Queue identity, Command-66 

QUEUE station command (version 2), B-2 

/QUEUE 

$PRINT command qualifier, 5-19 
$SUBMIT command qualifier, 5-16 

QUIT 

interactive station command, 7-2 
station command, Command-53 



/RAT file descriptor qualifier, 5-8 
/RD station command qualifier, Command-59 
Read permission control word, Command-61 
RECALL station command (version 2), B-2 
/RECEIVING station command qualifier, 

Command-69 
Record 

attributes, 5-8 

control words, 4-7 
RECORD station command, Command-54 
REFRESH 

command parameter, Command-62 

station command (version 2), B-2 
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Refresh style Cray context 

altering, 2-13 

central discussions, 2-9, Command-63 

moving through, 2-14 
Refreshed display area, 2-9 
Region divider, 2-9 
Relative file organization, 4-9 
RELEASE station command, Command-55 
/RELEASE station command qualifier, 

Command- 43 
Remote station, 1-2 
/REMOTE 

$PRINT command qualifier, 5-19 

$SUBMIT command qualifier, 5-16 
REMOVE station command, Command-56 
Reprieve processing, Command- 15 
Required software, iii 
RERUN station command, Command-58 
Retention period 

ACQUIRE, 4-3 

DISPOSE, 4-5, 5-1 

SAVE, Command-61 
/REWIND $TAPE command qualifier, 5-12 
/RFM 

file descriptor qualifier, 5-7 

$TAPE file qualifier, 5-14 
RMS relative- record file,, 5-7 
/RMS staging command qualifier, 5-4, 5-11 
/RT station command qualifier, Command-59 



SAVE station command, Command-59 
/SAVE station command qualifier 

BYE, Command- 16 

SHOW QUEUES, Command-65 
SCROLL command parameter, Command-62 
Scrolled command region, 2-9 
Selecting and accessing systems and modes, 

2-7 
Selection of Cray computer systems, 2-17 
/SENDING station command qualifier, 

Command-69 
Sequential file organization, 4-8 
SET HOST (DCL command), 1-2 
SET PROTECTION (DCL command), 5-13 
SET TERMINAL station command 

central discussions, 2-14, Command-62 

example, A-3 
SHOW QUEUES station command 

central discussion, Comraand-65 

example, A-3, A-4 
/SINCE station command qualifier, Command-43 
SNAP station command, Command-68 
Source file types 

/SPACE $PRINT file qualifier, 5-20 
special forms information, 4-5 
/SPOOL station command qualifier 

REMOVE, Command-56 

SHOW QUEUES, Command-65 
ST disposition code, 4-10, 5-1 
Staged dataset name 

DISPOSE, 4-5, 5-1 

FETCH, 4-4 



/STAGE station command qualifier 
REMOVE, Command-56 
SHOW QUEUES, Command-65 
Staging 

commands, 4-1, 5-1, 6-1 
dataset 

examples, A-6 

summary of related station commands, 
2-4, 4-10 

to COS, 4-2 

to VMS, 4-4 

types of, 4-1 

See also job submission (COS) and 
datasets 
queue, Command-56, Command-65 
STATCLASS station command (version 2), B-3 
Station codes, Command- 2 
Station commands 

abbreviation, 2-2 
descriptions 

+, Command-7 

-, Command-8 

@, Command- 9 

$, Command- 10 

CTRL/Z, Command- 11 

ABORT, Command- 12 

ATTACH, Command- 13 

ATTENTION, Command-15 

BYE, Command- 16 

CHOOSE, Command- 17 

CLEAR , Command- 1 9 

COLLECT, Command- 20 

COMMENT, Command-22 

CRAY, Command- 24 

DATASET, Command-27 

DELAY, Command- 29 

DISCARD, Command-30 

DROP, Command-31 

EOF, Command-32 

EXIT, Command- 33 

HELP, Command- 34 

INTERACTIVE, Command-35 

ISTATUS, Command-37 

JOB, Command-38 

JSTAT, Command- 40 

KILL, Command-42 

LOGFILE, Command-43 

LOOP, Command-46 

MESSAGE, Command-48 

PAUSE, Command-50 

PLAY, Command- 51 

QUIT, Command-53 

RECORD, Command-54 

RELEASE, Command-55 

REMOVE, Command-56 

RERUN, Command-58 

SAVE, Command-59 

SET TERMINAL, Command-62 

SHOW QUEUES, Command-65 

SNAP, Command-68 

STATUS, Command-69 

SUBMIT, Command-73 

SWITCH, Command-77 
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Station commands 

descriptions (continued) 
TAPE, Command-78 
TJOB, Command-80 

entry, 2-1 

format , 2-2 

prompting, 2-12 

recording, Command-54 

summary, 2-4, Command-3 
Station ID, Command-71 
STATUS station command 

description, command- 69 

example, A-4 
/STMSG station command qualifier, Command-43 
SUBMIT station command 

central discussions, 3-1, Command-73 

examples, 3-2, A-4 
$SUBMIT 

command qualifiers, 5-15 

DISPOSE staging command, 5-14 

file descriptor, 5-17 

file qualifiers, 5-17 
/SUCCESS station command qualifier, 

Command- 43 
SWITCH station command, Command- 77 
Symbol definition, 2-2 
Synonym definitions, 2-17 
SYS$INPUT, Command-74 
SYS$PRINT, 4-11 
System 

bulletin, A-14 

logfile (COS), Command-48 
/SYSTEM station command qualifier, 
Command-48 



Tape 

blocks, A-14 
data, A-14 
device 

information, Command-78 

reservation, A- 13 
displaying status of jobs, Command-78, 

Command-80 
jobs, Command-78, Command-80 
volumes, A-14 
$TAPE 

ACQUIRE/FETCH staging command, 6-6 
command qualifiers, 5-10, 6-6 
DISPOSE staging command, 5-10 
file 

descriptor, 5-12, 6-7 

qualifiers, 5-13, 6-7 
Target file organization 
$DISK, 5-7 
$TAPE, 5-13 
Terminal 

facilities, 2-1 
identifier 

ACQUIRE, 4-3 

DISPOSE, 4-5 

FETCH, 4-4 
width, Command-64 
working environment, Command-62 



TEXT field 

ACQUIRE, 4-3, 6-2 

dataset management defaults in the 
absence of, 4-11 

DISPOSE, 4-6, 5-2 

FETCH, 4-4, 6-2 
TID field, 4-7 

TIME station command (version 2) , B-3 
TJOB station command, Command-80 
TR dataset format, 5-1 
/TRANSLATE station command qualifier 

JSTAT, Command- 40 

LOGFILE, Command-43 

SHOW QUEUES, Command-65 

STATUS, Command-69 
Transparent dataset format, 4-7 
/TRNC staging command qualifier, 5-4 
Tutorial sessions, A-l 



/UNLOAD 

station command qualifier, 
Command-59 

$TAPE command qualifier, 5-12, 6-6 
Uppercase characters, Command-35 
User identification, 4-2 

/USER station command qualifier, Command-43 
/US station command qualifier, Command-59 



/VAX station command qualifier, Command-69 

VMS 

batch queue, 3-6 

block mode processing, 4-9 

destination file types, 4-10 

relative file organization, 4-9 

sequential file organization, 4-8 

source file types, 4-10 

UIC, Command-45, Command-67 

Volume 

name, 5-10, Command-61 
serial number, Command-79 

/VOLUME 

$TAPE command qualifier, 6-6 
/VOLUME station command qualifier, 
Command-59 



When codes, Command-2 
WIDTH command parameter, Command-62 
Write permission control word, Command-61 
/WSDEFAULT $SUBMIT command qualifier, 5-17 
/WSEXTENT $SUBMIT command qualifier, 5-17 
/WSQUOTA $SUBMIT command qualifier, 5-17 
/WT station command qualifier, Command-59 
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